MessageHeaderException 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
當處理訊息時，對 SOAP 訊息標頭的期望未被滿足時，會拋出的例外。
public ref class MessageHeaderException : System::ServiceModel::ProtocolExceptionpublic class MessageHeaderException : System.ServiceModel.ProtocolException[System.Serializable]
public class MessageHeaderException : System.ServiceModel.ProtocolExceptiontype MessageHeaderException = class
inherit ProtocolException[<System.Serializable>]
type MessageHeaderException = class
inherit ProtocolExceptionPublic Class MessageHeaderException
Inherits ProtocolException- 繼承
- 繼承
- 屬性
備註
此例外通常在標頭過多或訊息缺少標頭時拋出。 這可以包括基礎設施標頭，如動作標頭和可靠訊息標頭。 此例外源自 ProtocolException，而 又由 CommunicationException衍生 。 CommunicationException 類別代表一類可復原的錯誤，可能在端點間通訊時拋出，且強健Windows Communication Foundation（WCF）客戶端與服務應用預期會處理此類錯誤。 為防止較通用 CommunicationException 的處理器捕捉更具體 ProtocolException的例外，請在處理 CommunicationException前捕捉此例外。
建構函式
| 名稱 | Description |
|---|---|
| MessageHeaderException() |
初始化 MessageHeaderException 類別的新執行個體。 |
| MessageHeaderException(SerializationInfo, StreamingContext) |
初始化用於反序列化資料為MessageHeaderException物件的類別新實例MessageHeaderException。 |
| MessageHeaderException(String, Boolean) |
使用指定的訊息初始化類別的新實例 MessageHeaderException ，並設定一個表示訊息標頭是否重複或遺失的值。 |
| MessageHeaderException(String, Exception) |
使用指定的訊息及導致該例外的內部例外，初始化該類別的新 MessageHeaderException 實例。 |
| MessageHeaderException(String, String, String, Boolean, Exception) |
使用指定的訊息、標頭名稱與命名空間、指示訊息標頭是否重複或遺失的值，以及導致異常的內部例外，初始化類別的新 MessageHeaderException 實例。 |
| MessageHeaderException(String, String, String, Boolean) |
使用指定的訊息、標頭名稱與命名空間，以及指示訊息標頭是否重複或遺失的值，初始化該類別的新 MessageHeaderException 實例。 |
| MessageHeaderException(String, String, String, Exception) |
使用指定的訊息、標頭名稱與命名空間，以及導致異常的內部例外，初始化該類別的新 MessageHeaderException 實例。 |
| MessageHeaderException(String, String, String) |
使用指定的訊息、標頭名稱和命名空間初始化該 MessageHeaderException 類別的新實例。 |
| MessageHeaderException(String) |
初始化一個新的類別實例 MessageHeaderException ，並以指定訊息進行。 |
屬性
| 名稱 | Description |
|---|---|
| Data |
取得一組鍵值對，提供關於例外的額外使用者定義資訊。 (繼承來源 Exception) |
| HeaderName |
取得造成異常的 SOAP 標頭名稱。 |
| HeaderNamespace |
取得造成例外的 SOAP 標頭的命名空間。 |
| HelpLink |
取得或設定與此例外相關的說明檔案連結。 (繼承來源 Exception) |
| HResult |
取得或設定 HRESULT，一個編碼的數值，指派給特定例外。 (繼承來源 Exception) |
| InnerException |
會取得 Exception 造成目前例外的實例。 (繼承來源 Exception) |
| IsDuplicate |
會取得一個值，表示是否有多個訊息標頭或沒有訊息標頭。 |
| Message |
取得描述目前例外狀況的訊息。 (繼承來源 Exception) |
| Source |
取得或設定造成錯誤之應用程式或物件的名稱。 (繼承來源 Exception) |
| StackTrace |
會取得呼叫堆疊上即時框架的字串表示。 (繼承來源 Exception) |
| TargetSite |
會取得拋出當前例外的方法。 (繼承來源 Exception) |
方法
| 名稱 | Description |
|---|---|
| Equals(Object) |
判斷指定的物件是否等於目前的物件。 (繼承來源 Object) |
| GetBaseException() |
當在派生類別中被覆寫時，回傳 Exception 是一個或多個後續例外的根因。 (繼承來源 Exception) |
| GetHashCode() |
做為預設哈希函式。 (繼承來源 Object) |
| GetObjectData(SerializationInfo, StreamingContext) |
已淘汰.
在衍生類別中覆寫時，使用例外狀況的相關信息來設定 SerializationInfo。 (繼承來源 Exception) |
| GetType() |
取得目前實例的執行時型態。 (繼承來源 Exception) |
| MemberwiseClone() |
建立目前 Object的淺層複本。 (繼承來源 Object) |
| ToString() |
建立並回傳當前例外的字串表示。 (繼承來源 Exception) |
事件
| 名稱 | Description |
|---|---|
| SerializeObjectState |
已淘汰.
當例外被序列化以建立包含該例外序列化資料的例外狀態物件時，會發生這種情況。 (繼承來源 Exception) |
