Message.GetBody Метод

Определение

Извлекает текст данного экземпляра Message.Retrieves the body of this Message instance.

Перегрузки

GetBody<T>()

Извлекает текст данного экземпляра Message.Retrieves the body of this Message instance.

GetBody<T>(XmlObjectSerializer)

Извлекает текст данного экземпляра Message с использованием указанного сериализатора.Retrieves the body of this Message using the specified serializer.

Примеры

В следующем примере кода показан клиент, использующий фабрику каналов для отправки сообщения и чтения ответа.The following code example shows a client that uses the channel factory to send a message and read the reply.

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

Комментарии

После создания сообщения текст сообщения можно прочитать с помощью методов GetBody возвращаемого сообщения.After a message is created, the message body can be read using the GetBody methods on the returned message. Возвращенный объект инкапсулирует все дочерние элементы в элементе Body.The returned object encapsulates all the child elements within the Body element. Так как тело сообщения представляет собой поток, его можно прочитать или записать только один раз.Because the body of a message is a stream, it can only be written once, or read once.

Используйте перегружаемый метод GetBody<T>(XmlObjectSerializer) при работе с сообщениями JSON; перегружаемый метод GetBody<T>() не работает с сообщениями JSON.Use the GetBody<T>(XmlObjectSerializer) overload when working with JSON messages; the GetBody<T>() overload does not work.

GetBody<T>()

Извлекает текст данного экземпляра Message.Retrieves the body of this Message instance.

public:
generic <typename T>
 T GetBody();
public T GetBody<T> ();
member this.GetBody : unit -> 'T
Public Function GetBody(Of T) () As T

Параметры типа

T

Тело сообщения.The body of the message.

Возвраты

T

Объект типа T, содержащий тело данного сообщения.An object of type T that contains the body of this message.

Комментарии

Тело экземпляра Message соответствует телу SOAP.A Message instance has a body that corresponds to the SOAP body. Доступ к нему осуществляется с использованием XmlDictionaryReader путем вызова метода GetReaderAtBodyContents.It can be accessed as an XmlDictionaryReader by calling GetReaderAtBodyContents. Изначально средство чтения позиционируется сразу после элемента <S:Body>, по достижении элемента EOF средство чтения возвращает </S:Body>.It is initially positioned directly after the <S:Body> element, and it returns EOF on reaching the </S:Body> element. Если ожидается, что в теле содержится сериализуемый объект, можно вызвать метод GetBody.Alternatively, if you expect the body to contain a serialized object, you can call GetBody instead. Необходимо помнить, что к телу сообщения можно обратиться только один раз, и сообщение можно записать только один раз.You should be aware that a message body can only be accessed once and a message can only be written once. Если необходимо получить доступ к элементу Body несколько раз, используйте метод CreateBufferedCopy для создания экземпляра класса MessageBuffer.If you want to access the Body multiple times, use CreateBufferedCopy to create a MessageBuffer instance.

Используйте перегружаемый метод GetBody<T>(XmlObjectSerializer) при работе с сообщениями JSON; перегружаемый метод GetBody<T>() не работает с сообщениями JSON.Use the GetBody<T>(XmlObjectSerializer) overload when working with JSON messages; the GetBody<T>() overload does not work.

GetBody<T>(XmlObjectSerializer)

Извлекает текст данного экземпляра Message с использованием указанного сериализатора.Retrieves the body of this Message using the specified serializer.

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

Параметры типа

T

Тело сообщения.The body of the message.

Параметры

serializer
XmlObjectSerializer

Объект XmlObjectSerializer, используемый для чтения текста сообщения.A XmlObjectSerializer object used to read the body of the message.

Возвраты

T

Объект типа T, содержащий тело данного сообщения.An object of type T that contains the body of this message.

Исключения

Свойство serializer имеет значение null.serializer is null.

Комментарии

Тело экземпляра Message соответствует телу SOAP.A Message instance has a body that corresponds to the SOAP body. Доступ к нему осуществляется с использованием XmlDictionaryReader путем вызова метода GetReaderAtBodyContents.It can be accessed as an XmlDictionaryReader by calling GetReaderAtBodyContents. Изначально средство чтения позиционируется сразу после элемента <S:Body>, по достижении элемента EOF средство чтения возвращает </S:Body>.It is initially positioned directly after the <S:Body> element, and it returns EOF on reaching the </S:Body> element. Если ожидается, что в теле содержится сериализуемый объект, можно вызвать метод GetBody.Alternatively, if you expect the body to contain a serialized object, you can call GetBody instead. Необходимо помнить, что к телу сообщения можно обратиться только один раз, и сообщение можно записать только один раз.You should be aware that a message body can only be accessed once and a message can only be written once. Если необходимо получить доступ к тексту сообщения несколько раз, используйте метод CreateBufferedCopy для создания экземпляра класса MessageBuffer.If you want to access the body multiple times, use CreateBufferedCopy to create a MessageBuffer instance.

Используйте перегружаемый метод GetBody<T>(XmlObjectSerializer) при работе с сообщениями JSON; перегружаемый метод GetBody<T>() не работает с сообщениями JSON.Use the GetBody<T>(XmlObjectSerializer) overload when working with JSON messages; the GetBody<T>() overload does not work.

Применяется к