Message.GetBody Methode

Definition

Namespace:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Paket:

System.ServiceModel.Primitives v6.2.0

Ruft den Text dieser Message-Instanz ab.

Überlädt

GetBody<T>(XmlObjectSerializer)	Ruft den Text dieser Message mit dem angegebenen Serialisierungsprogramm ab.
GetBody<T>()	Ruft den Text dieser Message-Instanz ab.

Beispiele

Das folgende Codebeispiel zeigt einen Client, der die Kanalfactory zum Senden einer Nachricht und zum Lesen der Antwort verwendet.

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

Hinweise

Nach dem Erstellen einer Nachricht kann der Nachrichtentext mit den GetBody-Methoden für die zurückgegebene Nachricht gelesen werden. Das zurückgegebene Objekt kapselt alle untergeordneten Elemente innerhalb des Body-Elements. Da der Text einer Nachricht ein Stream ist, kann dieser nur einmal gelesen oder geschrieben werden.

Verwenden Sie bei der Arbeit mit JSON-Nachrichten die GetBody<T>(XmlObjectSerializer)-Überladung; die GetBody<T>()-Überladung funktioniert hier nicht.

GetBody<T>(XmlObjectSerializer)

Quelle:

Message.cs

Ruft den Text dieser Message mit dem angegebenen Serialisierungsprogramm ab.

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

Typparameter

T

Der Textkörper der Nachricht.

Parameter

serializer

XmlObjectSerializer

Ein XmlObjectSerializer-Objekt, mit dem der Text der Nachricht gelesen werden soll.

Gibt zurück

T

Ein Objekt des Typs T, das den Text dieser Nachricht enthält.

Ausnahmen

ArgumentNullException

serializer ist null

Hinweise

Eine Message-Instanz weist einen Text auf, der dem SOAP-Text entspricht. Darauf kann als XmlDictionaryReader zugegriffen werden, indem GetReaderAtBodyContents aufgerufen wird. Dies wird zunächst direkt nach dem <S:Body>-Element positioniert und gibt beim Erreichen des EOF-Elements </S:Body> zurück. Wenn Sie erwarten, dass der Text ein serialisiertes Objekt enthält, können Sie stattdessen auch GetBody aufrufen. Sie sollten beachten, dass ein Nachrichtentext nur einmal gelesen und eine Nachricht nur einmal geschrieben werden kann. Wenn Sie mehrmals auf den Text zugreifen möchten, verwenden Sie CreateBufferedCopy zum Erstellen einer MessageBuffer-Instanz.

Verwenden Sie bei der Arbeit mit JSON-Nachrichten die GetBody<T>(XmlObjectSerializer)-Überladung; die GetBody<T>()-Überladung funktioniert hier nicht.

GetBody<T>()

Quelle:

Message.cs

Ruft den Text dieser Message-Instanz ab.

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

public T GetBody<T> ();

member this.GetBody : unit -> 'T

Public Function GetBody(Of T) () As T

Typparameter

T

Der Textkörper der Nachricht.

Gibt zurück

T

Ein Objekt des Typs T, das den Text dieser Nachricht enthält.

Hinweise

Eine Message-Instanz weist einen Text auf, der dem SOAP-Text entspricht. Darauf kann als XmlDictionaryReader zugegriffen werden, indem GetReaderAtBodyContents aufgerufen wird. Dies wird zunächst direkt nach dem <S:Body>-Element positioniert und gibt beim Erreichen des EOF-Elements </S:Body> zurück. Wenn Sie erwarten, dass der Text ein serialisiertes Objekt enthält, können Sie stattdessen auch GetBody aufrufen. Sie sollten beachten, dass ein Nachrichtentext nur einmal gelesen und eine Nachricht nur einmal geschrieben werden kann. Wen Sie mehrmals auf den Body zugreifen möchten, verwenden Sie CreateBufferedCopy zum Erstellen einer MessageBuffer-Instanz.

Verwenden Sie bei der Arbeit mit JSON-Nachrichten die GetBody<T>(XmlObjectSerializer)-Überladung; die GetBody<T>()-Überladung funktioniert hier nicht.