Message.GetBody Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Recupera el cuerpo de esta Message instancia.
Sobrecargas
| Nombre | Description |
|---|---|
| GetBody<T>() |
Recupera el cuerpo de esta Message instancia. |
| GetBody<T>(XmlObjectSerializer) |
Recupera el cuerpo de esto Message mediante el serializador especificado. |
Ejemplos
En el ejemplo de código siguiente se muestra un cliente que usa el generador de canales para enviar un mensaje y leer la respuesta.
using System;
using System.Collections.Generic;
using System.Text;
using System.ServiceModel;
using System.ServiceModel.Channels;
using System.Runtime.Serialization;
namespace ConsoleApplication1
{
class client
{
static void RunClient()
{
//Step1: create a binding with just HTTP
CustomBinding binding = new CustomBinding();
binding.Elements.Add(new HttpTransportBindingElement());
//Step2: use the binding to build the channel factory
IChannelFactory<IRequestChannel> factory =
binding.BuildChannelFactory<IRequestChannel>(
new BindingParameterCollection());
//open the channel factory
factory.Open();
//Step3: use the channel factory to create a channel
IRequestChannel channel = factory.CreateChannel(
new EndpointAddress("http://localhost:8080/channelapp"));
channel.Open();
//Step4: create a message
Message requestmessage = Message.CreateMessage(
MessageVersion.Soap12WSAddressing10,
"http://contoso.com/someaction",
"This is the body data");
//send message
Message replymessage = channel.Request(requestmessage);
Console.WriteLine("Reply message received");
Console.WriteLine("Reply action: {0}",
replymessage.Headers.Action);
string data = replymessage.GetBody<string>();
Console.WriteLine("Reply content: {0}", data);
//Step5: don't forget to close the message
requestmessage.Close();
replymessage.Close();
//don't forget to close the channel
channel.Close();
//don't forget to close the factory
factory.Close();
}
public static void Main()
{
Console.WriteLine("Press [ENTER] when service is ready");
Console.ReadLine();
RunClient();
Console.WriteLine("Press [ENTER] to exit");
Console.ReadLine();
}
}
}
Imports System.Collections.Generic
Imports System.Text
Imports System.ServiceModel
Imports System.ServiceModel.Channels
Imports System.Runtime.Serialization
Namespace ConsoleApplication1
Friend Class client
Private Shared Sub RunClient()
'Step1: create a binding with just HTTP
Dim binding As New CustomBinding()
binding.Elements.Add(New HttpTransportBindingElement())
'Step2: use the binding to build the channel factory
Dim factory As IChannelFactory(Of IRequestChannel) = binding.BuildChannelFactory(Of IRequestChannel)(New BindingParameterCollection())
'open the channel factory
factory.Open()
'Step3: use the channel factory to create a channel
Dim channel As IRequestChannel = factory.CreateChannel(New EndpointAddress("http://localhost:8080/channelapp"))
channel.Open()
'Step4: create a message
Dim requestmessage As Message = Message.CreateMessage(MessageVersion.Soap12WSAddressing10, "http://contoso.com/someaction", "This is the body data")
'send message
Dim replymessage As Message = channel.Request(requestmessage)
Console.WriteLine("Reply message received")
Console.WriteLine("Reply action: {0}", replymessage.Headers.Action)
Dim data = replymessage.GetBody(Of String)()
Console.WriteLine("Reply content: {0}", data)
'Step5: don't forget to close the message
requestmessage.Close()
replymessage.Close()
'don't forget to close the channel
channel.Close()
'don't forget to close the factory
factory.Close()
End Sub
Public Shared Sub Main()
Console.WriteLine("Press [ENTER] when service is ready")
Console.ReadLine()
RunClient()
Console.WriteLine("Press [ENTER] to exit")
Console.ReadLine()
End Sub
End Class
End Namespace
Comentarios
Una vez creado un mensaje, el cuerpo del mensaje se puede leer mediante los GetBody métodos del mensaje devuelto. El objeto devuelto encapsula todos los elementos secundarios del Body elemento . Dado que el cuerpo de un mensaje es una secuencia, solo se puede escribir una vez o leer una vez.
Use la GetBody<T>(XmlObjectSerializer) sobrecarga al trabajar con mensajes JSON; la GetBody<T>() sobrecarga no funciona.
GetBody<T>()
- Source:
- Message.cs
- Source:
- Message.cs
- Source:
- Message.cs
Recupera el cuerpo de esta Message instancia.
public:
generic <typename T>
T GetBody();
public T GetBody<T>();
member this.GetBody : unit -> 'T
Public Function GetBody(Of T) () As T
Parámetros de tipo
- T
El cuerpo del mensaje.
Devoluciones
Objeto de tipo T que contiene el cuerpo de este mensaje.
Comentarios
Una Message instancia tiene un cuerpo que corresponde al cuerpo SOAP. Se puede acceder a él como un mediante una XmlDictionaryReader llamada a GetReaderAtBodyContents. Inicialmente se coloca directamente después del <S:Body> elemento y vuelve EOF al llegar al </S:Body> elemento. Como alternativa, si espera que el cuerpo contenga un objeto serializado, puede llamar a GetBody en su lugar. Debe tener en cuenta que solo se puede acceder a un cuerpo del mensaje una vez y un mensaje solo se puede escribir una vez. Si desea acceder a varias Body veces, use CreateBufferedCopy para crear una MessageBuffer instancia.
Use la GetBody<T>(XmlObjectSerializer) sobrecarga al trabajar con mensajes JSON; la GetBody<T>() sobrecarga no funciona.
Se aplica a
GetBody<T>(XmlObjectSerializer)
- Source:
- Message.cs
- Source:
- Message.cs
- Source:
- Message.cs
Recupera el cuerpo de esto Message mediante el serializador especificado.
public:
generic <typename T>
T GetBody(System::Runtime::Serialization::XmlObjectSerializer ^ serializer);
public T GetBody<T>(System.Runtime.Serialization.XmlObjectSerializer serializer);
member this.GetBody : System.Runtime.Serialization.XmlObjectSerializer -> 'T
Public Function GetBody(Of T) (serializer As XmlObjectSerializer) As T
Parámetros de tipo
- T
El cuerpo del mensaje.
Parámetros
- serializer
- XmlObjectSerializer
Objeto XmlObjectSerializer utilizado para leer el cuerpo del mensaje.
Devoluciones
Objeto de tipo T que contiene el cuerpo de este mensaje.
Excepciones
serializer es null.
Comentarios
Una Message instancia tiene un cuerpo que corresponde al cuerpo SOAP. Se puede acceder a él como un mediante una XmlDictionaryReader llamada a GetReaderAtBodyContents. Inicialmente se coloca directamente después del <S:Body> elemento y vuelve EOF al llegar al </S:Body> elemento. Como alternativa, si espera que el cuerpo contenga un objeto serializado, puede llamar a GetBody en su lugar. Debe tener en cuenta que solo se puede acceder a un cuerpo del mensaje una vez y un mensaje solo se puede escribir una vez. Si desea acceder al cuerpo varias veces, use CreateBufferedCopy para crear una MessageBuffer instancia.
Use la GetBody<T>(XmlObjectSerializer) sobrecarga al trabajar con mensajes JSON; la GetBody<T>() sobrecarga no funciona.