Message.GetBody Metoda

Definicja

Przestrzeń nazw:

System.ServiceModel.Channels

Zestaw:

System.ServiceModel.Primitives.dll

Pakiet:

System.ServiceModel.Primitives v8.0.0

Pobiera treść tego Message wystąpienia.

Przeciążenia

GetBody<T>(XmlObjectSerializer)	Pobiera treść tego Message elementu przy użyciu określonego serializatora.
GetBody<T>()	Pobiera treść tego Message wystąpienia.

Przykłady

Poniższy przykład kodu przedstawia klienta, który używa fabryki kanałów do wysyłania wiadomości i odczytywania odpowiedzi.

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

Uwagi

Po utworzeniu komunikatu treść komunikatu może być odczytywana przy użyciu GetBody metod zwracanych komunikatów. Zwrócony obiekt hermetyzuje wszystkie elementy podrzędne w elemecie Body . Ponieważ treść wiadomości jest strumieniem, można ją zapisać tylko raz lub odczytać raz.

GetBody<T>(XmlObjectSerializer) Użyj przeciążenia podczas pracy z komunikatami JSON; GetBody<T>() przeciążenie nie działa.

GetBody<T>(XmlObjectSerializer)

Źródło:

Message.cs

Pobiera treść tego Message elementu przy użyciu określonego serializatora.

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

Parametry typu

T

Treść wiadomości.

Parametry

serializer

XmlObjectSerializer

XmlObjectSerializer Obiekt używany do odczytywania treści wiadomości.

Zwraca

T

Obiekt typu T , który zawiera treść tego komunikatu.

Wyjątki

ArgumentNullException

serializer to null.

Uwagi

Wystąpienie Message ma treść odpowiadającą treści protokołu SOAP. Dostęp do niego można uzyskać za XmlDictionaryReader pomocą wywołania metody GetReaderAtBodyContents. Jest on początkowo umieszczony bezpośrednio po <S:Body> elemecie i zwracany EOF po osiągnięciu </S:Body> elementu. Alternatywnie, jeśli oczekujesz, że treść będzie zawierać obiekt serializowany, możesz wywołać GetBody zamiast tego. Należy pamiętać, że treść wiadomości może być dostępna tylko raz, a komunikat można napisać tylko raz. Jeśli chcesz uzyskać dostęp do treści wiele razy, użyj polecenia CreateBufferedCopy , aby utworzyć MessageBuffer wystąpienie.

GetBody<T>(XmlObjectSerializer) Użyj przeciążenia podczas pracy z komunikatami JSON; GetBody<T>() przeciążenie nie działa.

GetBody<T>()

Źródło:

Message.cs

Pobiera treść tego Message wystąpienia.

public:
generic <typename T>
 T GetBody();

public T GetBody<T> ();

member this.GetBody : unit -> 'T

Public Function GetBody(Of T) () As T

Parametry typu

T

Treść wiadomości.

Zwraca

T

Obiekt typu T , który zawiera treść tego komunikatu.

Uwagi

Wystąpienie Message ma treść odpowiadającą treści protokołu SOAP. Dostęp do niego można uzyskać za XmlDictionaryReader pomocą wywołania metody GetReaderAtBodyContents. Jest on początkowo umieszczony bezpośrednio po <S:Body> elemecie i zwracany EOF po osiągnięciu </S:Body> elementu. Alternatywnie, jeśli oczekujesz, że treść będzie zawierać obiekt serializowany, możesz wywołać GetBody zamiast tego. Należy pamiętać, że treść wiadomości może być dostępna tylko raz, a komunikat można napisać tylko raz. Jeśli chcesz uzyskać dostęp do Body wielu razy, użyj polecenia CreateBufferedCopy , aby utworzyć MessageBuffer wystąpienie.

GetBody<T>(XmlObjectSerializer) Użyj przeciążenia podczas pracy z komunikatami JSON; GetBody<T>() przeciążenie nie działa.