MessageHeader 類別

定義

命名空間:

System.ServiceModel.Channels

組件:

System.ServiceModel.Primitives.dll

套件:

System.ServiceModel.Primitives v6.2.0

來源:

MessageHeader.cs

表示 SOAP 標頭的內容。

public ref class MessageHeader abstract : System::ServiceModel::Channels::MessageHeaderInfo

public abstract class MessageHeader : System.ServiceModel.Channels.MessageHeaderInfo

type MessageHeader = class
    inherit MessageHeaderInfo

Public MustInherit Class MessageHeader
Inherits MessageHeaderInfo

繼承

Object

MessageHeaderInfo

MessageHeader

備註

訊息標頭包含選擇性中繼資料，其中描述由 Message 類別所封裝的訊息。

Message 可以有零個或更多的標頭 (當做擴充機制使用)，以便在應用程式特定的訊息中傳遞資訊。 您可以藉由呼叫 Headers 方法，使用 Add 將訊息標頭新增至訊息中。

Windows Communication Foundation (WCF) 提供許多預先定義的訊息標頭，如下表所示。

標頭名稱	描述
收件者	包含此訊息所針對的角色。
動作	提供應該如何處理此訊息的說明。
FaultTo	包含錯誤應該傳送之目標節點的位址。
寄件者	包含傳送訊息之節點的位址。
要求	指出此訊息是否為要求。
MessageID	包含此訊息的唯一 ID。
RelatesTo	包含與此訊息相關之訊息的 ID。
ReplyTo	包含應該針對要求傳送回覆之目標節點的位址。

建構函式

MessageHeader()

初始化 MessageHeader 類別的新執行個體。

屬性

Actor	取得或設定訊息標頭的目標收件者。
IsReferenceParameter	取得值，此值會指定此訊息標頭是否包含端點參考的參考參數。
MustUnderstand	取得或設定值，表示是否必須依照 SOAP 1.1/1.2 規格的說明來解讀標頭。
Name	取得訊息標頭的名稱。 (繼承來源 MessageHeaderInfo)
Namespace	取得訊息標頭的命名空間。 (繼承來源 MessageHeaderInfo)
Relay	取得值，這個值會指出是否應該轉送標頭。

方法

CreateHeader(String, String, Object)	使用指定的資料來建立新的訊息標頭。
CreateHeader(String, String, Object, Boolean)	使用指定的資料來建立新的訊息標頭。
CreateHeader(String, String, Object, Boolean, String)	使用指定的資料來建立新的訊息標頭。
CreateHeader(String, String, Object, Boolean, String, Boolean)	使用指定的資料來建立新的訊息標頭。
CreateHeader(String, String, Object, XmlObjectSerializer)	使用 XmlFormatter 從要序列化的物件建立標頭。
CreateHeader(String, String, Object, XmlObjectSerializer, Boolean)	使用指定的資料來建立新的訊息標頭。
CreateHeader(String, String, Object, XmlObjectSerializer, Boolean, String)	使用指定的資料來建立新的訊息標頭。
CreateHeader(String, String, Object, XmlObjectSerializer, Boolean, String, Boolean)	使用指定的資料來建立新的訊息標頭。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
IsMessageVersionSupported(MessageVersion)	驗證是否支援指定的訊息版本。
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
OnWriteHeaderContents(XmlDictionaryWriter, MessageVersion)	當使用指定的 XML 寫入器序列化標頭內容時呼叫。
OnWriteStartHeader(XmlDictionaryWriter, MessageVersion)	當使用指定的 XML 寫入器序列化開始標頭時呼叫。
ToString()	傳回這個訊息標頭的字串表示。
WriteHeader(XmlDictionaryWriter, MessageVersion)	使用指定的 XML 寫入器序列化此標頭。
WriteHeader(XmlWriter, MessageVersion)	使用指定的 XML 寫入器序列化此標頭。
WriteHeaderAttributes(XmlDictionaryWriter, MessageVersion)	使用指定的 XML 寫入器序列化標頭屬性。
WriteHeaderContents(XmlDictionaryWriter, MessageVersion)	使用指定的 XML 寫入器序列化標頭內容。
WriteStartHeader(XmlDictionaryWriter, MessageVersion)	使用指定的 XML 寫入器序列化開始標頭。