Message.GetBody Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft den Textkörper dieser Message Instanz ab.
Überlädt
| Name | Beschreibung |
|---|---|
| GetBody<T>() |
Ruft den Textkörper dieser Message Instanz ab. |
| GetBody<T>(XmlObjectSerializer) |
Ruft den Textkörper dieser Message Mithilfe des angegebenen Serialisierers ab. |
Beispiele
Das folgende Codebeispiel zeigt einen Client, der die Kanalfactory verwendet, um eine Nachricht zu senden und die Antwort zu lesen.
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
Nachdem eine Nachricht erstellt wurde, kann der Nachrichtentext mithilfe der GetBody Methoden für die zurückgegebene Nachricht gelesen werden. Das zurückgegebene Objekt kapselt alle untergeordneten Elemente innerhalb des Body Elements. Da der Textkörper einer Nachricht ein Datenstrom ist, kann er nur einmal geschrieben oder einmal gelesen werden.
Verwenden Sie die GetBody<T>(XmlObjectSerializer) Überladung beim Arbeiten mit JSON-Nachrichten; die GetBody<T>() Überladung funktioniert nicht.
GetBody<T>()
- Quelle:
- Message.cs
- Quelle:
- Message.cs
- Quelle:
- Message.cs
Ruft den Textkörper 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 Text der Nachricht.
Gibt zurück
Ein Objekt vom Typ T , das den Textkörper dieser Nachricht enthält.
Hinweise
Eine Message Instanz verfügt über einen Textkörper, der dem SOAP-Text entspricht. Auf sie kann durch XmlDictionaryReader Aufrufen GetReaderAtBodyContentszugegriffen werden. Sie wird zunächst direkt nach dem <S:Body> Element positioniert und gibt EOF zurück, wenn es das </S:Body> Element erreicht. Wenn Sie jedoch erwarten, dass der Textkörper ein serialisiertes Objekt enthält, können Sie stattdessen aufrufen GetBody . Beachten Sie, dass nur einmal auf einen Nachrichtentext zugegriffen werden kann und eine Nachricht nur einmal geschrieben werden kann. Wenn Sie mehrmals auf die Body Instanz zugreifen möchten, verwenden CreateBufferedCopy Sie dies zum Erstellen einer MessageBuffer Instanz.
Verwenden Sie die GetBody<T>(XmlObjectSerializer) Überladung beim Arbeiten mit JSON-Nachrichten; die GetBody<T>() Überladung funktioniert nicht.
Gilt für:
GetBody<T>(XmlObjectSerializer)
- Quelle:
- Message.cs
- Quelle:
- Message.cs
- Quelle:
- Message.cs
Ruft den Textkörper dieser Message Mithilfe des angegebenen Serialisierers 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 Text der Nachricht.
Parameter
- serializer
- XmlObjectSerializer
Ein XmlObjectSerializer Objekt, das zum Lesen des Nachrichtentexts verwendet wird.
Gibt zurück
Ein Objekt vom Typ T , das den Textkörper dieser Nachricht enthält.
Ausnahmen
serializer ist null.
Hinweise
Eine Message Instanz verfügt über einen Textkörper, der dem SOAP-Text entspricht. Auf sie kann durch XmlDictionaryReader Aufrufen GetReaderAtBodyContentszugegriffen werden. Sie wird zunächst direkt nach dem <S:Body> Element positioniert und gibt EOF zurück, wenn es das </S:Body> Element erreicht. Wenn Sie jedoch erwarten, dass der Textkörper ein serialisiertes Objekt enthält, können Sie stattdessen aufrufen GetBody . Beachten Sie, dass nur einmal auf einen Nachrichtentext zugegriffen werden kann und eine Nachricht nur einmal geschrieben werden kann. Wenn Sie mehrmals auf den Textkörper zugreifen möchten, erstellen CreateBufferedCopy Sie eine MessageBuffer Instanz.
Verwenden Sie die GetBody<T>(XmlObjectSerializer) Überladung beim Arbeiten mit JSON-Nachrichten; die GetBody<T>() Überladung funktioniert nicht.