Message.Headers Propriété

Définition

Espace de noms:

System.ServiceModel.Channels

Assemblys:

System.ServiceModel.dll, System.ServiceModel.Primitives.dll

Paquet:

System.ServiceModel.Primitives v10.0.652802

Source:

Message.cs

En cas de substitution dans une classe dérivée, obtient les en-têtes du message.

public:
 abstract property System::ServiceModel::Channels::MessageHeaders ^ Headers { System::ServiceModel::Channels::MessageHeaders ^ get(); };

public abstract System.ServiceModel.Channels.MessageHeaders Headers { get; }

member this.Headers : System.ServiceModel.Channels.MessageHeaders

Public MustOverride ReadOnly Property Headers As MessageHeaders

Valeur de propriété

MessageHeaders

Objet MessageHeaders qui représente les en-têtes du message.

Exceptions

ObjectDisposedException

Le message a été supprimé.

Exemples

L’exemple de code suivant montre un client qui utilise la fabrique de canaux pour envoyer un message et 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

Un Message peut avoir zéro ou plusieurs en-têtes utilisés comme mécanisme d’extension pour transmettre des informations dans des messages spécifiques à l’application. Vous pouvez utiliser Headers pour ajouter des en-têtes de message à un message en appelant la Add méthode.

Windows Communication Foundation (WCF) fournit un certain nombre d’en-têtes de message prédéfinis, comme indiqué dans le tableau suivant.

Nom de l’en-tête	Contient le nom de l’en-tête.
À	Contient le rôle que le message cible.
Action	Fournit une description de la façon dont le message doit être traité.
FaultTo	Contient l’adresse du nœud auquel les erreurs doivent être envoyées.
De	Contient l’adresse du nœud qui a envoyé le message.
Requête	Indique si le message est une requête.
Identifiant de Message	Contient l’ID unique du message.
RelationsTo	Contient les ID des messages liés à ce message.
ReplyTo	Contient l’adresse du nœud auquel une réponse doit être envoyée pour une demande.

Notes pour les responsables de l’implémentation

En cas de substitution dans une classe dérivée, cette méthode retourne un MessageHeaders objet pour les en-têtes du message.