Message.GetBody Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Haalt de hoofdtekst van dit Message exemplaar op.
Overloads
| Name | Description |
|---|---|
| GetBody<T>() |
Haalt de hoofdtekst van dit Message exemplaar op. |
| GetBody<T>(XmlObjectSerializer) |
Haalt de hoofdtekst hiervan op met behulp van Message de opgegeven serializer. |
Voorbeelden
In het volgende codevoorbeeld ziet u een client die gebruikmaakt van de kanaalfactory om een bericht te verzenden en het antwoord te lezen.
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
Opmerkingen
Nadat een bericht is gemaakt, kan de hoofdtekst van het bericht worden gelezen met behulp van de GetBody methoden op het geretourneerde bericht. Het geretourneerde object bevat alle onderliggende elementen in het Body element. Omdat de hoofdtekst van een bericht een stroom is, kan het slechts één keer worden geschreven of één keer worden gelezen.
Gebruik de GetBody<T>(XmlObjectSerializer) overbelasting bij het werken met JSON-berichten. De GetBody<T>() overbelasting werkt niet.
GetBody<T>()
Haalt de hoofdtekst van dit Message exemplaar op.
public:
generic <typename T>
T GetBody();
public T GetBody<T>();
member this.GetBody : unit -> 'T
Public Function GetBody(Of T) () As T
Type parameters
- T
De hoofdtekst van het bericht.
Retouren
Een object van het type T dat de hoofdtekst van dit bericht bevat.
Opmerkingen
Een Message exemplaar heeft een hoofdtekst die overeenkomt met de SOAP-hoofdtekst. Het kan worden geopend als een XmlDictionaryReader door aan te roepen GetReaderAtBodyContents. Het element wordt in eerste instantie direct na het <S:Body> element positioneerd en wordt geretourneerd EOF bij het bereiken van het </S:Body> element. Als u verwacht dat de hoofdtekst een geserialiseerd object bevat, kunt u in plaats daarvan aanroepen GetBody . U moet er rekening mee houden dat een berichttekst slechts eenmaal kan worden geopend en dat een bericht slechts één keer kan worden geschreven. Als u meerdere Body keren toegang wilt krijgen, gebruikt CreateBufferedCopy u om een MessageBuffer exemplaar te maken.
Gebruik de GetBody<T>(XmlObjectSerializer) overbelasting bij het werken met JSON-berichten. De GetBody<T>() overbelasting werkt niet.
Van toepassing op
GetBody<T>(XmlObjectSerializer)
Haalt de hoofdtekst hiervan op met behulp van Message de opgegeven serializer.
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
Type parameters
- T
De hoofdtekst van het bericht.
Parameters
- serializer
- XmlObjectSerializer
Een XmlObjectSerializer object dat wordt gebruikt om de hoofdtekst van het bericht te lezen.
Retouren
Een object van het type T dat de hoofdtekst van dit bericht bevat.
Uitzonderingen
serializer is null.
Opmerkingen
Een Message exemplaar heeft een hoofdtekst die overeenkomt met de SOAP-hoofdtekst. Het kan worden geopend als een XmlDictionaryReader door aan te roepen GetReaderAtBodyContents. Het element wordt in eerste instantie direct na het <S:Body> element positioneerd en wordt geretourneerd EOF bij het bereiken van het </S:Body> element. Als u verwacht dat de hoofdtekst een geserialiseerd object bevat, kunt u in plaats daarvan aanroepen GetBody . U moet er rekening mee houden dat een berichttekst slechts eenmaal kan worden geopend en dat een bericht slechts één keer kan worden geschreven. Als u meerdere keren toegang wilt tot de hoofdtekst, gebruikt CreateBufferedCopy u om een MessageBuffer exemplaar te maken.
Gebruik de GetBody<T>(XmlObjectSerializer) overbelasting bij het werken met JSON-berichten. De GetBody<T>() overbelasting werkt niet.