Message.GetBody Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recupera o corpo desta Message instância.
Sobrecargas
| Name | Description |
|---|---|
| GetBody<T>() |
Recupera o corpo desta Message instância. |
| GetBody<T>(XmlObjectSerializer) |
Recupera o corpo disto Message usando o serializador especificado. |
Exemplos
O exemplo de código seguinte mostra um cliente que usa a channel factory para enviar uma mensagem e ler a resposta.
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
Observações
Após a criação de uma mensagem, o corpo da mensagem pode ser lido usando os GetBody métodos da mensagem devolvida. O objeto devolvido encapsula todos os elementos filhos dentro do Body elemento. Como o corpo de uma mensagem é um fluxo, só pode ser escrito uma vez, ou lido uma vez.
Use a GetBody<T>(XmlObjectSerializer) sobrecarga ao trabalhar com mensagens JSON; a GetBody<T>() sobrecarga não funciona.
GetBody<T>()
- Origem:
- Message.cs
- Origem:
- Message.cs
- Origem:
- Message.cs
Recupera o corpo desta Message instância.
public:
generic <typename T>
T GetBody();
public T GetBody<T>();
member this.GetBody : unit -> 'T
Public Function GetBody(Of T) () As T
Parâmetros de Tipo Genérico
- T
O corpo da mensagem.
Devoluções
Um objeto do tipo T que contém o corpo desta mensagem.
Observações
Uma Message instância tem um corpo que corresponde ao corpo SOAP. Pode ser acedido como um XmlDictionaryReader chamando GetReaderAtBodyContents. Inicialmente, posiciona-se diretamente após o <S:Body> elemento e regressa EOF ao atingir o </S:Body> elemento. Alternativamente, se esperar que o corpo contenha um objeto serializado, pode chamar GetBody em vez disso. Deves estar ciente de que o corpo da mensagem só pode ser acedido uma vez e uma mensagem só pode ser escrita uma vez. Se quiseres aceder várias Body vezes, usa CreateBufferedCopy para criar uma MessageBuffer instância.
Use a GetBody<T>(XmlObjectSerializer) sobrecarga ao trabalhar com mensagens JSON; a GetBody<T>() sobrecarga não funciona.
Aplica-se a
GetBody<T>(XmlObjectSerializer)
- Origem:
- Message.cs
- Origem:
- Message.cs
- Origem:
- Message.cs
Recupera o corpo disto Message usando o serializador especificado.
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
Parâmetros de Tipo Genérico
- T
O corpo da mensagem.
Parâmetros
- serializer
- XmlObjectSerializer
Um XmlObjectSerializer objeto usado para ler o corpo da mensagem.
Devoluções
Um objeto do tipo T que contém o corpo desta mensagem.
Exceções
serializer é null.
Observações
Uma Message instância tem um corpo que corresponde ao corpo SOAP. Pode ser acedido como um XmlDictionaryReader chamando GetReaderAtBodyContents. Inicialmente, posiciona-se diretamente após o <S:Body> elemento e regressa EOF ao atingir o </S:Body> elemento. Alternativamente, se esperar que o corpo contenha um objeto serializado, pode chamar GetBody em vez disso. Deves estar ciente de que o corpo da mensagem só pode ser acedido uma vez e uma mensagem só pode ser escrita uma vez. Se quiseres aceder ao corpo várias vezes, usa CreateBufferedCopy para criar uma MessageBuffer instância.
Use a GetBody<T>(XmlObjectSerializer) sobrecarga ao trabalhar com mensagens JSON; a GetBody<T>() sobrecarga não funciona.