Message.GetBody Méthode

Définition

Espace de noms:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Paquet:

System.ServiceModel.Primitives v6.2.0

Récupère le corps de cette instance Message.

Surcharges

GetBody<T>(XmlObjectSerializer)	Récupère le corps de ce Message à l'aide du sérialiseur spécifié.
GetBody<T>()	Récupère le corps de cette instance Message.

Exemples

L'exemple de code suivant illustre un client qui utilise la fabrication de canal pour envoyer un message et en lire la réponse.

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

Remarques

Après qu'un message a été créé, son corps peut être lu à l'aide des méthodes GetBody sur le message retourné. L'objet retourné encapsule tous les éléments enfants dans l'élément Body. Le corps d'un message constituant un flux de données, il ne peut être lu ou écrit qu'une seule fois.

Utilisez la surcharge de la méthode GetBody<T>(XmlObjectSerializer) si vous faites appel à des messages JSON ; la surcharge de la méthode GetBody<T>() ne fonctionne pas.

GetBody<T>(XmlObjectSerializer)

Source:

Message.cs

Récupère le corps de ce Message à l'aide du sérialiseur spécifié.

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

Paramètres de type

T

le corps du message.

Paramètres

serializer

XmlObjectSerializer

Objet XmlObjectSerializer utilisé pour lire le corps du message.

Retours

T

Objet de type T qui contient le corps du message.

Exceptions

ArgumentNullException

serializer a la valeur null.

Remarques

Le corps d'une instance Message se calque sur le corps SOAP. Elle est accessible en tant que XmlDictionaryReader en appelant GetReaderAtBodyContents. Elle est initialement placée directement après l'élément <S:Body>, et elle retourne EOF dès qu'elle atteint l'élément </S:Body>. Ou bien, si vous attendez que le corps contienne un objet sérialisé, vous pouvez appeler à la place GetBody. Il convient de savoir que le corps d'un message n'est accessible qu'une seule fois et que le message peut être écrit une fois seulement aussi. Si vous souhaitez accéder au corps plusieurs fois, utilisez CreateBufferedCopy pour créer une instance MessageBuffer.

Utilisez la surcharge de la méthode GetBody<T>(XmlObjectSerializer) si vous faites appel à des messages JSON ; la surcharge de la méthode GetBody<T>() ne fonctionne pas.

GetBody<T>()

Source:

Message.cs

Récupère le corps de cette instance Message.

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

public T GetBody<T> ();

member this.GetBody : unit -> 'T

Public Function GetBody(Of T) () As T

Paramètres de type

T

le corps du message.

Retours

T

Objet de type T qui contient le corps du message.

Remarques

Le corps d'une instance Message se calque sur le corps SOAP. Elle est accessible en tant que XmlDictionaryReader en appelant GetReaderAtBodyContents. Elle est initialement placée directement après l'élément <S:Body>, et elle retourne EOF dès qu'elle atteint l'élément </S:Body>. Ou bien, si vous attendez que le corps contienne un objet sérialisé, vous pouvez appeler à la place GetBody. Il convient de savoir que le corps d'un message n'est accessible qu'une seule fois et que le message peut être écrit une fois seulement aussi. Si vous souhaitez accéder à Body à plusieurs reprises, utilisez CreateBufferedCopy pour créer une instance MessageBuffer.

Utilisez la surcharge de la méthode GetBody<T>(XmlObjectSerializer) si vous faites appel à des messages JSON ; la surcharge de la méthode GetBody<T>() ne fonctionne pas.