Message Classe

Définition

public ref class Message abstract : IDisposable

public abstract class Message : IDisposable

type Message = class
    interface IDisposable

Public MustInherit Class Message
Implements IDisposable

Héritage

Object

Message

Implémente

IDisposable

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

La classe Message permet de communiquer des informations arbitraires entre un expéditeur et un destinataire sur un réseau. Elle peut servir à relayer des informations, suggérer ou même demander un plan d'action ou des données.

La structure d'un objet Message représente une enveloppe SOAP. Elle comporte deux parties distinctes : le corps du message et une collection d’en-têtes facultative, représentée par la classe Headers. Le contenu du message consiste en des données définies par l'application et envoyées par un expéditeur à un destinataire. Les en-têtes de message favorisent une extensibilité du système et des applications qui répond à vos besoins d’évolution puisque vous pouvez définir le code permettant de manipuler et de répondre à des en-têtes spécifiques. Vous pouvez également définir vos propres en-têtes. Les en-têtes de message sont sérialisés ou désérialisés avec le contenu du message.

Les messages sont reçus et envoyés dans des formats particuliers. Deux formats sont pris en charge : le format XML texte standard et un format XML binaire. L'objet Message peut être utilisé pour représenter les enveloppes SOAP 1.1 et SOAP 1.2. Notez qu'une instance de Message est résolue à la création et est liée à une version SOAP spécifique. La propriété Version représente la version SOAP du message.

Un objet Message peut être sérialisé vers un magasin externe à l'aide de la méthode WriteMessage. Les propriétés du message peuvent également être sérialisées, mais elles doivent être identifiées individuellement et sérialisées séparément. La désérialisation d'un message pour créer un objet Message en mémoire peut se faire à l'aide de CreateMessage. Les propriétés doivent également être désérialisées individuellement et ajoutées manuellement dans la collection des propriétés pour l’instance Message spécifique.

La taille d'un objet Message est fixée sur la taille des données que cet objet transmet. Chaque corps est modelé comme une instance de XmlReader, sans aucune limite prédéfinie pour la taille du flux de données que l'instance XmlReader encapsule. Toutefois, des fournisseurs de canal spécifiques peuvent définir une limite pour la taille des messages qu'ils traitent.

Un Message peut être annoté avec des informations utiles générées par une entité qui a examiné et traité le message. Cette fonctionnalité est fournie par les propriétés Headers et Properties. La collection Headers représente le jeu d’en-têtes SOAP sur le message.

La propriété Properties représente le jeu d'annotations au niveau de traitement sur le message. Du fait que les informations contenues dans les en-têtes sont transmises par câble, une entité qui examine un en-tête doit prendre en charge la ou les versions sous-jacentes des protocoles utilisés par l'en-tête. Toutefois, les propriétés offrent un moyen d'annoter un message plus indépendant de la version.

Pour créer une instance Message, utilisez l'une des méthodes CreateMessage.

Il est recommandé que le consommateur d'un message appelle toujours Close lorsqu'il a fini de consommer le contenu du message. Cette action libère des ressources système finies (par exemple, des sockets, des canaux nommés) liées à la durée de vie du message.

Remarque spéciale destinée aux utilisateurs C++ managés dérivés de cette classe :

• Placez votre code de nettoyage dans (On)(Begin)Close (et/ou OnAbort), pas dans un destructeur.

• Évitez les destructeurs car ils provoquent la génération automatique de IDisposable par le compilateur.

• Évitez les membres sans référence car ils peuvent provoquer la génération automatique de IDisposable par le compilateur.

• Évitez les finaliseurs ; cependant, si vous en incluez un, vous devrez supprimer l'avertissement de génération et appeler SuppressFinalize(Object) et le finaliseur depuis (On)(Begin)Close (et/ou OnAbort) pour émuler le comportement prévu propre à l'interface IDisposable générée automatiquement.

Notes pour les responsables de l’implémentation

Lorsque vous héritez de Message, vous devez remplacer les membres suivants : Headers et Version.

Constructeurs

Propriétés

Méthodes

Implémentations d’interfaces explicites

Méthodes d’extension

S’applique à