Message.Headers Eigenschaft

Definition

Namespace:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Paket:

System.ServiceModel.Primitives v6.2.0

Quelle:

Message.cs

Ruft beim Überschreiben in einer abgeleiteten Klasse die Header der Nachricht ab.

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

Eigenschaftswert

MessageHeaders

Ein MessageHeaders-Objekt, das die Header der Nachricht darstellt.

Ausnahmen

ObjectDisposedException

Die Nachricht wurde verworfen.

Beispiele

Das folgende Codebeispiel zeigt einen Client, der die Kanalfactory zum Senden einer Nachricht und zum Lesen der Antwort verwendet.

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

Hinweise

Message kann über 0 (null) oder mehr Header verfügen, die als Erweiterungsmechanismus zur Weitergabe von Informationen an die anwendungsspezifischen Nachrichten verwendet werden. Sie können Headers verwenden, um einer Nachricht Nachrichtenheader hinzuzufügen, indem Sie die Add-Methode aufrufen.

Windows Communication Foundation (WCF) stellt eine Reihe vordefinierter Nachrichtenheader bereit, wie in der folgenden Tabelle gezeigt.

Headername	Enthält den Headernamen.
An	Enthält die Rolle, auf die die Nachricht abzielt.
Aktion	Beschreibt, wie die Nachricht verarbeitet werden sollte.
FaultTo	Enthält die Adresse des Knotens, an den Fehler gesendet werden sollten.
From	Enthält die Adresse des Knotens, der die Nachricht gesendet hat.
Anforderung	Gibt an, ob die Nachricht eine Anforderung ist.
Meldungs-ID	Enthält die eindeutige ID der Nachricht.
RelatesTo	Enthält die IDs der Nachrichten, die zu dieser Nachricht gehören.
ReplyTo	Enthält die Adresse des Knotens, an den für eine Anforderung eine Antwort gesendet werden soll.

Hinweise für Ausführende

Wenn sie in einer abgeleiteten Klasse überschrieben wird, gibt diese Methode ein MessageHeaders-Objekt für die Header der Nachricht zurück.