SoapHeaderException 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
伺服器錯誤的 SOAP 表示。
public ref class SoapHeaderException : System::Web::Services::Protocols::SoapExceptionpublic class SoapHeaderException : System.Web.Services.Protocols.SoapException[System.Serializable]
public class SoapHeaderException : System.Web.Services.Protocols.SoapExceptiontype SoapHeaderException = class
inherit SoapException[<System.Serializable>]
type SoapHeaderException = class
inherit SoapExceptionPublic Class SoapHeaderException
Inherits SoapException- 繼承
- 屬性
範例
在下列範例中，XML Web 服務用戶端會呼叫 MyWebMethod XML Web 服務方法，並傳入 型 MyHeader MustUnderstand 別為 的 SOAP 標頭，並將 屬性設定為 true 。 如果 XML Web 服務方法未將 SOAP 標頭的 MyHeader 屬性設定 DidUnderstand 為 true ， SoapHeaderException 則會擲回 。
int main()
{
MyWebService^ ws = gcnew MyWebService;
try
{
MyHeader^ customHeader = gcnew MyHeader;
customHeader->MyValue = "Header Value for MyValue";
customHeader->MustUnderstand = true;
ws->myHeader = customHeader;
int results = ws->MyWebMethod( 3, 5 );
}
catch ( Exception^ e )
{
Console::WriteLine( "Exception: {0}", e );
}
}
using System;
public class Sample {
public static void Main() {
MyWebService ws = new MyWebService();
try {
MyHeader customHeader = new MyHeader();
customHeader.MyValue = "Header Value for MyValue";
customHeader.MustUnderstand = true;
ws.myHeader = customHeader;
int results = ws.MyWebMethod(3,5);
}
catch (Exception e) {
Console.WriteLine ("Exception: {0}", e.ToString());
}
}
}
Public Class Sample
Public Shared Sub Main()
Dim ws As New MyWebService()
Try
Dim customHeader As New MyHeader1()
customHeader.MyValue = "Header Value for MyValue"
customHeader.MustUnderstand = True
ws.myHeader = customHeader
Dim results As Integer
results = ws.MyWebMethod(3,5)
Catch e As Exception
Console.WriteLine("Exception: {0}", e.ToString())
End Try
End Sub
End Class
備註
當 XML Web 服務用戶端將 SOAP 標頭新增至 XML Web 服務方法呼叫，並將 MustUnderstand 屬性設定 true 為 時， SoapHeaderException XML Web 服務方法必須將 屬性設定 DidUnderstand 為 true ，否則會擲回 。
Detail屬性無法根據 的 SoapHeaderException SOAP 規格進行設定。
注意
使用 SOAP 1.1 規格作為服務通訊協定的應用程式可以使用 SoapHeaderException 來存取 SOAP 錯誤。 不過，使用 SOAP 1.2 規格的應用程式必須使用 SoapException 來存取 SOAP 錯誤。
建構函式
屬性
| Actor |
取得造成例外狀況的程式碼部分。 (繼承來源 SoapException) |
| Code |
取得 SOAP 錯誤碼的類型。 (繼承來源 SoapException) |
| Data |
取得鍵值組的集合，這些鍵值組會提供關於例外狀況的其他使用者定義資訊。 (繼承來源 Exception) |
| Detail |
取得 XmlNode，表示應用程式特定的錯誤資訊明細。 (繼承來源 SoapException) |
| HelpLink |
取得或設定與這個例外狀況相關聯的說明檔連結。 (繼承來源 Exception) |
| HResult |
取得或設定 HRESULT，它是指派給特定例外狀況的編碼數值。 (繼承來源 Exception) |
| InnerException |
取得造成目前例外狀況的 Exception 執行個體。 (繼承來源 Exception) |
| Lang |
取得與這個例外狀況相關聯的人類語言。 (繼承來源 SoapException) |
| Message |
取得描述目前例外狀況的訊息。 (繼承來源 Exception) |
| Node |
取得 URI，表示造成例外狀況的程式碼片段。 (繼承來源 SoapException) |
| Role |
取得 URI，表示處理 SOAP 訊息的 XML Web Service 的功能。 (繼承來源 SoapException) |
| Source |
取得或設定造成錯誤的應用程式或物件的名稱。 (繼承來源 Exception) |
| StackTrace |
取得呼叫堆疊上即時運算框架的字串表示。 (繼承來源 Exception) |
| SubCode |
取得包含在 SOAP 錯誤的 |
| TargetSite |
取得擲回目前例外狀況的方法。 (繼承來源 Exception) |
方法
| Equals(Object) |
判斷指定的物件是否等於目前的物件。 (繼承來源 Object) |
| GetBaseException() |
在衍生類別中覆寫時，傳回一或多個後續的例外狀況的根本原因 Exception。 (繼承來源 Exception) |
| GetHashCode() |
做為預設雜湊函式。 (繼承來源 Object) |
| GetObjectData(SerializationInfo, StreamingContext) |
使用例外狀況的相關資訊來設定 SerializationInfo。 (繼承來源 SoapException) |
| GetType() |
取得目前執行個體的執行階段類型。 (繼承來源 Exception) |
| MemberwiseClone() |
建立目前 Object 的淺層複製。 (繼承來源 Object) |
| ToString() |
建立並傳回目前例外狀況的字串表示。 (繼承來源 Exception) |
事件
| SerializeObjectState |
已過時。
當例外狀況序列化，以建立包含例外狀況相關序列化資料的例外狀況狀態物件時，就會發生此事件。 (繼承來源 Exception) |