Message.GetBody Método

Definición

Espacio de nombres:

System.ServiceModel.Channels

Ensamblado:

System.ServiceModel.Primitives.dll

Paquete:

System.ServiceModel.Primitives v6.2.0

Recupera el cuerpo de esta instancia de Message.

Sobrecargas

GetBody<T>(XmlObjectSerializer)	Recupera el cuerpo de Message utilizando el serializador especificado.
GetBody<T>()	Recupera el cuerpo de esta instancia de Message.

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 utilizando los métodos GetBody en el mensaje devuelto. El objeto devuelto encapsula todos los elementos secundarios dentro del elemento Body. Puesto que el cuerpo de un mensaje es una secuencia, sólo se puede escribir una vez o leer una vez.

Use la sobrecarga GetBody<T>(XmlObjectSerializer) cuando trabaje con mensajes JSON; la sobrecarga GetBody<T>() no funciona.

GetBody<T>(XmlObjectSerializer)

Source:

Message.cs

Recupera el cuerpo de Message utilizando 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

Un objeto de XmlObjectSerializer usado para leer el cuerpo del mensaje.

Devoluciones

T

Un objeto de tipo T que contiene el cuerpo de este mensaje.

Excepciones

ArgumentNullException

serializer es null.

Comentarios

Una instancia Message tiene un cuerpo que se corresponde con el cuerpo de SOAP. Se puede tener acceso como un XmlDictionaryReader llamando a GetReaderAtBodyContents. Se coloca inicialmente directamente después del elemento <S:Body> y vuelve EOF al alcanzar el elemento </S:Body>. Alternativamente, si espera que el cuerpo contenga un objeto serializado, puede llamar en su lugar a GetBody. Debe ser consciente de que sólo se puede tener acceso a un cuerpo del mensaje una vez y que sólo se puede escribir un mensaje una vez. Si desea tener acceso al cuerpo varias veces, use CreateBufferedCopy para crear una instancia de MessageBuffer.

Use la sobrecarga GetBody<T>(XmlObjectSerializer) cuando trabaje con mensajes JSON; la sobrecarga GetBody<T>() no funciona.

GetBody<T>()

Source:

Message.cs

Recupera el cuerpo de esta instancia de Message.

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

T

Un objeto de tipo T que contiene el cuerpo de este mensaje.

Comentarios

Una instancia Message tiene un cuerpo que se corresponde con el cuerpo de SOAP. Se puede tener acceso como un XmlDictionaryReader llamando a GetReaderAtBodyContents. Se coloca inicialmente directamente después del elemento <S:Body> y vuelve EOF al alcanzar el elemento </S:Body>. Alternativamente, si espera que el cuerpo contenga un objeto serializado, puede llamar en su lugar a GetBody. Debe ser consciente de que sólo se puede tener acceso a un cuerpo del mensaje una vez y que sólo se puede escribir un mensaje una vez. Si desea tener acceso varias veces a Body, utilice CreateBufferedCopy para crear una instancia MessageBuffer.

Use la sobrecarga GetBody<T>(XmlObjectSerializer) cuando trabaje con mensajes JSON; la sobrecarga GetBody<T>() no funciona.