MessageHeaders Classe

Definizione

Spazio dei nomi:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Pacchetto:

System.ServiceModel.Primitives v6.2.0

Source:

MessageHeaders.cs

Rappresenta una raccolta di intestazioni relative a un messaggio. La classe non può essere ereditata.

public ref class MessageHeaders sealed : System::Collections::Generic::IEnumerable<System::ServiceModel::Channels::MessageHeaderInfo ^>

public sealed class MessageHeaders : System.Collections.Generic.IEnumerable<System.ServiceModel.Channels.MessageHeaderInfo>

type MessageHeaders = class
    interface seq<MessageHeaderInfo>
    interface IEnumerable

Public NotInheritable Class MessageHeaders
Implements IEnumerable(Of MessageHeaderInfo)

Ereditarietà

Object

MessageHeaders

Implementazioni

IEnumerable<MessageHeaderInfo> IEnumerable

Esempio

L'esempio di codice seguente mostra un client di base che utilizza la channel factory per inviare un messaggio e leggere l'intestazione azione dalla replica.

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

Commenti

Un'intestazione di messaggio contiene metadati facoltativi che descrivono un messaggio incapsulato dalla classe Message.

Un Message può avere zero o più intestazioni utilizzate come meccanismo di estensione per passare informazioni nei messaggi specifici dell'applicazione. È possibile utilizzare Headers per aggiungere intestazioni a un messaggio chiamando il metodo Add.

Windows Communication Foundation (WCF) fornisce una serie di intestazioni di messaggio predefinite:

Nome dell'intestazione	Descrizione
A	Contiene il ruolo a cui fa riferimento il messaggio.
Azione	Fornisce una descrizione di come deve essere elaborato il messaggio.
FaultTo	Contiene l'indirizzo del nodo al quale devono essere inviati gli errori.
Da	Contiene l'indirizzo del nodo da cui è stato inviato il messaggio.
Richiesta	Indica se il messaggio è una richiesta.
MessageID	Contiene l'ID univoco del messaggio.
RelatesTo	Contiene gli ID dei messaggi relativi a questo messaggio.
ReplyTo	Contiene l'indirizzo del nodo al quale deve essere inviata la risposta a una richiesta.

Costruttori

MessageHeaders(MessageHeaders)	Inizializza una nuova istanza della classe MessageHeaders con la raccolta di intestazioni di messaggio specificata.
MessageHeaders(MessageVersion)	Inizializza una nuova istanza della classe MessageHeaders con la versione messaggio specificata.
MessageHeaders(MessageVersion, Int32)	Inizializza una nuova istanza della classe MessageHeaders con la versione e la dimensione messaggio specificate.

Proprietà

Action	Ottiene o imposta una descrizione della modalità di elaborazione del messaggio.
Count	Ottiene il numero di intestazioni di messaggio presenti in questa raccolta.
FaultTo	Ottiene o imposta l'indirizzo del nodo al quale devono essere inviati gli errori.
From	Ottiene o imposta l'indirizzo del nodo da cui è stato inviato il messaggio.
Item[Int32]	Recupera un'intestazione in corrispondenza dell'indice specificato.
MessageId	Ottiene o imposta l'ID univoco del messaggio.
MessageVersion	Ottiene la versione SOAP del messaggio.
RelatesTo	Ottiene gli ID dei messaggi relativi a questo messaggio.
ReplyTo	Ottiene o imposta l'indirizzo del nodo al quale deve essere inviata la risposta a una richiesta.
To	Ottiene o imposta l'endpoint di destinazione di un messaggio.
UnderstoodHeaders	Ottiene tutte le intestazioni di messaggio che devono essere riconosciute in base alla specifica SOAP 1.1/1.2.

Metodi

Add(MessageHeader)	Aggiunge alla raccolta l'intestazione del messaggio specificata.
Clear()	Rimuove tutte le intestazioni dalla raccolta.
CopyHeaderFrom(Message, Int32)	Copia il contenuto dell'intestazione situato in corrispondenza dell'indice specificato dal messaggio specificato a questa istanza.
CopyHeaderFrom(MessageHeaders, Int32)	Copia il contenuto dell'intestazione situato in corrispondenza dell'indice specificato dalla raccolta di intestazioni di messaggio specificata a questa istanza.
CopyHeadersFrom(Message)	Copia il contenuto di tutte le intestazioni dal messaggio specificato a questa istanza.
CopyHeadersFrom(MessageHeaders)	Copia il contenuto della raccolta di intestazioni specificata a questa istanza.
CopyTo(MessageHeaderInfo[], Int32)	Copia le intestazioni da questa raccolta a una matrice, a partire da un determinato indice della matrice.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
FindHeader(String, String)	Consente di individuare un'intestazione di messaggio in questa raccolta in base al valore LocalName e all'URI dello spazio dei nomi dell'elemento intestazione specificati.
FindHeader(String, String, String[])	Consente di individuare un'intestazione di messaggio in questa raccolta in base al valore LocalName, all'URI dello spazio dei nomi e agli attori dell'elemento intestazione specificati.
GetEnumerator()	Restituisce un enumeratore per scorrere l'insieme. Questo metodo non può essere ereditato.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetHeader<T>(Int32)	Recupera un'intestazione di messaggio in una posizione specifica della raccolta.
GetHeader<T>(Int32, XmlObjectSerializer)	Recupera un'intestazione di messaggio in una posizione specifica della raccolta.
GetHeader<T>(String, String)	Consente di individuare un'intestazione di messaggio in questa raccolta in base al valore LocalName e all'URI dello spazio dei nomi dell'elemento intestazione specificati.
GetHeader<T>(String, String, String[])	Recupera un'intestazione di messaggio in questa raccolta in base al valore LocalName, all'URI dello spazio dei nomi e agli attori dell'elemento intestazione specificati.
GetHeader<T>(String, String, XmlObjectSerializer)	Recupera un'intestazione di messaggio in questa raccolta in base al valore LocalName, all'URI dello spazio dei nomi e al serializzatore specificati.
GetReaderAtHeader(Int32)	Ottiene un lettore di dizionario XML che utilizza l'intestazione del messaggio nel percorso specificato della raccolta.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
HaveMandatoryHeadersBeenUnderstood()	Verifica se tutte le intestazioni di messaggio contrassegnate da MustUnderstand sono state interpretate ed elaborate correttamente.
HaveMandatoryHeadersBeenUnderstood(String[])	Verifica se i destinatari specificati hanno interpretato ed elaborato correttamente tutte le intestazioni di messaggio contrassegnate da MustUnderstand.
Insert(Int32, MessageHeader)	Inserisce un'intestazione di messaggio nella raccolta in corrispondenza dell'indice specificato.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
RemoveAll(String, String)	Rimuove dalla raccolta tutte le intestazioni con il nome e lo spazio dei nomi specificati.
RemoveAt(Int32)	Rimuove l'intestazione di messaggio dalla raccolta in corrispondenza dell'indice specificato.
SetAction(XmlDictionaryString)	Imposta l'elemento azione dell'intestazione.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
WriteHeader(Int32, XmlDictionaryWriter)	Serializza l'intestazione dal percorso specificato utilizzando il writer XML specificato.
WriteHeader(Int32, XmlWriter)	Serializza l'intestazione dal percorso specificato utilizzando il writer XML specificato.
WriteHeaderContents(Int32, XmlDictionaryWriter)	Serializza il contenuto dell'intestazione specificata utilizzando il writer XML specificato.
WriteHeaderContents(Int32, XmlWriter)	Serializza il contenuto dell'intestazione specificata utilizzando il writer XML specificato.
WriteStartHeader(Int32, XmlDictionaryWriter)	Serializza l'intestazione iniziale utilizzando il writer XML specificato.
WriteStartHeader(Int32, XmlWriter)	Serializza l'intestazione iniziale utilizzando il writer XML specificato.

Implementazioni dell'interfaccia esplicita

IEnumerable.GetEnumerator()

Restituisce un enumeratore per scorrere l'insieme. Questo metodo non può essere ereditato.

Metodi di estensione