Message.Headers Propriedade

Definição

Namespace:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Pacote:

System.ServiceModel.Primitives v8.0.0

Origem:

Message.cs

Quando substituído em uma classe derivada, obtém os cabeçalhos da mensagem.

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

Valor da propriedade

MessageHeaders

Um objeto MessageHeaders que representa os cabeçalhos da mensagem.

Exceções

ObjectDisposedException

A mensagem foi descartada.

Exemplos

O exemplo de código a seguir mostra um cliente que usa a fábrica de canais 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

Comentários

Um Message pode ter zero ou mais cabeçalhos que são usados como um mecanismo de extensão para passar informações em mensagens específicas do aplicativo. Você pode usar Headers para adicionar cabeçalhos de mensagem a uma mensagem chamando o Add método .

O WCF (Windows Communication Foundation) fornece vários cabeçalhos de mensagem predefinidos, conforme mostrado na tabela a seguir.

Nome do cabeçalho	Contém o nome do cabeçalho.
Para	Contém a função que a mensagem está direcionando.
Ação	Fornece uma descrição de como a mensagem deve ser processada.
FaultTo	Contém o endereço do nó para o qual as falhas devem ser enviadas.
De	Contém o endereço do nó que enviou a mensagem.
Solicitação	Indica se a mensagem é uma solicitação.
MessageID	Contém a ID exclusiva da mensagem.
RelatesTo	Contém as IDs de mensagens relacionadas a essa mensagem.
ReplyTo	Contém o endereço do nó para o qual uma resposta deve ser enviada para uma solicitação.

Notas aos Implementadores

Quando substituído em uma classe derivada, esse método retorna um MessageHeaders objeto para os cabeçalhos da mensagem.