Message.GetBody 方法

定義

命名空間:

System.ServiceModel.Channels

組件:

System.ServiceModel.Primitives.dll

套件:

System.ServiceModel.Primitives v6.2.0

擷取這個 Message 執行個體的本文。

多載

GetBody<T>(XmlObjectSerializer)	使用指定的序列化程式來擷取這個 Message 的本文。
GetBody<T>()	擷取這個 Message 執行個體的本文。

範例

下列程式碼範例會示範使用通道處理站傳送訊息和讀取回覆的用戶端。

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 方法加以讀取。 傳回的物件會將所有子項目都封裝於 Body 項目中。 由於訊息的本文是資料流，因此只能寫入或讀取一次。

當使用 JSON 訊息時，請使用 GetBody<T>(XmlObjectSerializer) 多載，因為 GetBody<T>() 多載不會運作。

GetBody<T>(XmlObjectSerializer)

來源:

Message.cs

使用指定的序列化程式來擷取這個 Message 的本文。

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

訊息的主體。

參數

serializer

XmlObjectSerializer

用來讀取訊息內容的 XmlObjectSerializer 物件。

傳回

T

型別為 T 的物件，其中包含此訊息的本文。

例外狀況

ArgumentNullException

serializer 為 null。

備註

Message 執行個體的本文對應至 SOAP 本文。 您可以呼叫 XmlDictionaryReader，將其當做 GetReaderAtBodyContents 來存取。 它最初是直接放置在 <S:Body> 項目之後，並且在到達 EOF 項目時傳回 </S:Body>。 或者，如果您希望本文包含已序列化的物件，可以改為呼叫 GetBody。 請注意，您只能存取一次訊息本文，而且只能寫入一次訊息。 如果您要多次存取本文，請使用 CreateBufferedCopy 建立 MessageBuffer 執行個體。

當使用 JSON 訊息時，請使用 GetBody<T>(XmlObjectSerializer) 多載，因為 GetBody<T>() 多載不會運作。

GetBody<T>()

來源:

Message.cs

擷取這個 Message 執行個體的本文。

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

public T GetBody<T> ();

member this.GetBody : unit -> 'T

Public Function GetBody(Of T) () As T

類型參數

T

訊息的主體。

傳回

T

型別為 T 的物件，其中包含此訊息的本文。

備註

Message 執行個體的本文對應至 SOAP 本文。 您可以呼叫 XmlDictionaryReader，將其當做 GetReaderAtBodyContents 來存取。 它最初是直接放置在 <S:Body> 項目之後，並且在到達 EOF 項目時傳回 </S:Body>。 或者，如果您希望本文包含已序列化的物件，可以改為呼叫 GetBody。 請注意，您只能存取一次訊息本文，而且只能寫入一次訊息。 如果您要多次存取 Body，請使用 CreateBufferedCopy 建立 MessageBuffer 執行個體。

當使用 JSON 訊息時，請使用 GetBody<T>(XmlObjectSerializer) 多載，因為 GetBody<T>() 多載不會運作。