MessageHeaders Sınıf

Tanım

Ad Alanı:

System.ServiceModel.Channels

Bütünleştirilmiş Kod:

System.ServiceModel.Primitives.dll

Paket:

System.ServiceModel.Primitives v6.2.0

Kaynak:

MessageHeaders.cs

İletinin ileti üst bilgileri koleksiyonunu temsil eder. Bu sınıf devralınamaz.

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)

Devralma

Object

MessageHeaders

Uygulamalar

IEnumerable<MessageHeaderInfo> IEnumerable

Örnekler

Aşağıdaki kod örneği, bir ileti göndermek ve yanıttan eylem üst bilgisini okumak için kanal fabrikasını kullanan temel bir istemciyi gösterir.

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

Açıklamalar

İleti üst bilgisi, sınıfı tarafından Message kapsüllenen bir iletiyi açıklayan isteğe bağlı meta veriler içerir.

, Message uygulamaya özgü iletilere bilgi geçirmek için uzantı mekanizması olarak kullanılan sıfır veya daha fazla üst bilgiye sahip olabilir. yöntemini çağırarak Add iletiye ileti üst bilgileri eklemek için komutunu Headers kullanabilirsiniz.

Windows Communication Foundation (WCF), önceden tanımlanmış bir dizi ileti üst bilgisi sağlar:

Üst Bilgi Adı	Açıklama
Amaç	İletinin hedeflediğini rolü içerir.
Eylem	İletinin nasıl işlenmesi gerektiğine ilişkin bir açıklama sağlar.
FaultTo	Hataların gönderilmesi gereken düğümün adresini içerir.
Kaynak	İletiyi gönderen düğümün adresini içerir.
İstek	İletinin bir istek olup olmadığını gösterir.
Messageıd	İletinin benzersiz kimliğini içerir.
RelatesTo	Bu iletiyle ilgili iletilerin kimliklerini içerir.
Replyto	İstek için yanıt gönderilmesi gereken düğümün adresini içerir.

Oluşturucular

MessageHeaders(MessageHeaders)	Belirtilen ileti üst bilgileri koleksiyonuyla sınıfının yeni bir örneğini MessageHeaders başlatır.
MessageHeaders(MessageVersion)	Belirtilen ileti sürümüyle sınıfının yeni bir örneğini MessageHeaders başlatır.
MessageHeaders(MessageVersion, Int32)	Belirtilen ileti sürümü ve boyutuyla sınıfının yeni bir örneğini MessageHeaders başlatır.

Özellikler

Action	İletinin nasıl işleneceğinin açıklamasını alır veya ayarlar.
Count	Bu koleksiyondaki ileti üst bilgilerinin sayısını alır.
FaultTo	Hataların gönderilmesi gereken düğümün adresini alır veya ayarlar.
From	İletiyi gönderen düğümün adresini alır veya ayarlar.
Item[Int32]	Verilen dizinde bir üst bilgi alır.
MessageId	İletinin benzersiz kimliğini alır veya ayarlar.
MessageVersion	İletinin SOAP sürümünü alır.
RelatesTo	Bu iletiyle ilgili iletilerin kimliklerini alır.
ReplyTo	İstek için yanıt gönderilmesi gereken düğümün adresini alır veya ayarlar.
To	İletinin hedef uç noktasını alır veya ayarlar.
UnderstoodHeaders	SOAP 1.1/1.2 belirtimine göre anlaşılması gereken tüm ileti üst bilgilerini alır.

Yöntemler

Add(MessageHeader)	Belirtilen ileti üst bilgisini koleksiyona ekler.
Clear()	Koleksiyondaki tüm üst bilgileri kaldırır.
CopyHeaderFrom(Message, Int32)	Belirtilen dizinde bulunan üst bilgi içeriğini belirtilen iletiden bu örneğe kopyalar.
CopyHeaderFrom(MessageHeaders, Int32)	Belirtilen dizinde bulunan üst bilgi içeriğini belirtilen ileti üst bilgisi koleksiyonundan bu örneğe kopyalar.
CopyHeadersFrom(Message)	Belirtilen iletideki tüm üst bilgilerin içeriğini bu örneğe kopyalar.
CopyHeadersFrom(MessageHeaders)	Belirtilen üst bilgi koleksiyonundaki içeriği bu örneğe kopyalar.
CopyTo(MessageHeaderInfo[], Int32)	Üst bilgileri bu koleksiyondan dizinin belirli bir dizininden başlayarak bir diziye kopyalar.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
FindHeader(String, String)	Bu koleksiyonda, üst bilgi öğesinin belirtilen LocalName ve ad alanı URI'sine göre bir ileti üst bilgisi bulur.
FindHeader(String, String, String[])	Belirtilen LocalName, ad alanı URI'si ve üst bilgi öğesinin aktörleri tarafından bu koleksiyonda bir ileti üst bilgisi bulur.
GetEnumerator()	Koleksiyonda yineleme için bir numaralandırıcı döndürür. Bu yöntem devralınamaz.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetHeader<T>(Int32)	Bu koleksiyonda belirli bir konumdaki bir ileti üst bilgisini alır.
GetHeader<T>(Int32, XmlObjectSerializer)	Bu koleksiyonda belirli bir konumdaki bir ileti üst bilgisini alır.
GetHeader<T>(String, String)	Bu koleksiyonda, üst bilgi öğesinin belirtilen LocalName ve ad alanı URI'sine göre bir ileti üst bilgisi bulur.
GetHeader<T>(String, String, String[])	Belirtilen LocalName, ad alanı URI'si ve üst bilgi öğesinin aktörleri tarafından bu koleksiyondaki bir ileti üst bilgisini alır.
GetHeader<T>(String, String, XmlObjectSerializer)	Belirtilen LocalName, ad alanı URI'si ve seri hale getirici tarafından bu koleksiyondaki bir ileti üst bilgisini alır.
GetReaderAtHeader(Int32)	koleksiyonun belirtilen konumunda ileti üst bilgisini kullanan bir XML sözlük okuyucusu alır.
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
HaveMandatoryHeadersBeenUnderstood()	ile MustUnderstand işaretlenen tüm ileti üst bilgilerinin düzgün yorumlanıp yorumlanmamış ve işlenip işlenmediğini doğrular.
HaveMandatoryHeadersBeenUnderstood(String[])	Belirtilen alıcıların ile MustUnderstandişaretlenmiş tüm ileti üst bilgilerini düzgün yorumlayıp işlemediğini doğrular.
Insert(Int32, MessageHeader)	Belirtilen dizindeki koleksiyona bir ileti üst bilgisi ekler.
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
RemoveAll(String, String)	Belirtilen ada ve ad alanına sahip tüm üst bilgileri koleksiyondan kaldırır.
RemoveAt(Int32)	Belirtilen dizindeki ileti üst bilgisini koleksiyondan kaldırır.
SetAction(XmlDictionaryString)	Üst bilginin eylem öğesini ayarlar.
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)
WriteHeader(Int32, XmlDictionaryWriter)	Belirtilen XML yazıcısını kullanarak belirtilen konumdan üst bilgiyi serileştirir.
WriteHeader(Int32, XmlWriter)	Belirtilen XML yazıcısını kullanarak belirtilen konumdan üst bilgiyi serileştirir.
WriteHeaderContents(Int32, XmlDictionaryWriter)	Belirtilen XML yazıcısını kullanarak belirtilen üst bilgi içeriğini serileştirir.
WriteHeaderContents(Int32, XmlWriter)	Belirtilen XML yazıcısını kullanarak belirtilen üst bilgi içeriğini serileştirir.
WriteStartHeader(Int32, XmlDictionaryWriter)	Belirtilen XML yazıcısını kullanarak başlangıç üst bilgisini serileştirir.
WriteStartHeader(Int32, XmlWriter)	Belirtilen XML yazıcısını kullanarak başlangıç üst bilgisini serileştirir.

Belirtik Arabirim Kullanımları

IEnumerable.GetEnumerator()

Koleksiyonda yineleme için bir numaralandırıcı döndürür. Bu yöntem devralınamaz.

Uzantı Metotları