Message.GetBody 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取回這個 Message 實例的身體。
多載
| 名稱 | Description |
|---|---|
| GetBody<T>() |
取回這個 Message 實例的身體。 |
| GetBody<T>(XmlObjectSerializer) |
使用指定的序列化器擷取此文件 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>()
- 來源:
- Message.cs
- 來源:
- Message.cs
- 來源:
- 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 ,包含此訊息的正文。
備註
一個 Message 實例的主體對應於 SOAP 主體。 可透過呼叫 XmlDictionaryReader來存取GetReaderAtBodyContents。 它最初位於元素後<S:Body>方,抵達元素後EOF會返回</S:Body>。 或者,如果你預期主體會包含序列化的物件,也可以 GetBody 呼叫 你應該知道訊息主體只能存取一次,訊息只能寫一次。 如果你想多次存取, Body 請用 CreateBufferedCopy 來建立一個 MessageBuffer 實例。
處理 JSON 訊息時使用 GetBody<T>(XmlObjectSerializer) 過載; GetBody<T>() 過載無法運作。
適用於
GetBody<T>(XmlObjectSerializer)
- 來源:
- Message.cs
- 來源:
- Message.cs
- 來源:
- 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 ,包含此訊息的正文。
例外狀況
serializer 是 null。
備註
一個 Message 實例的主體對應於 SOAP 主體。 可透過呼叫 XmlDictionaryReader來存取GetReaderAtBodyContents。 它最初位於元素後<S:Body>方,抵達元素後EOF會返回</S:Body>。 或者,如果你預期主體會包含序列化的物件,也可以 GetBody 呼叫 你應該知道訊息主體只能存取一次,訊息只能寫一次。 如果你想多次存取身體,可以用來 CreateBufferedCopy 建立一個 MessageBuffer 實例。
處理 JSON 訊息時使用 GetBody<T>(XmlObjectSerializer) 過載; GetBody<T>() 過載無法運作。