WebException 類別

定義

命名空間:

System.Net

組件:

netstandard.dll, System.Net.Requests.dll

來源:

WebException.cs

當透過可插拔協定存取網路時發生錯誤時拋出的例外。

public ref class WebException : InvalidOperationException

public class WebException : InvalidOperationException

type WebException = class
    inherit InvalidOperationException
    interface ISerializable

Public Class WebException
Inherits InvalidOperationException

繼承

Object

Exception

SystemException

InvalidOperationException

WebException

實作

ISerializable

備註

這個 WebException 類別是由其後代 WebRequest 的類別拋出，這些 WebResponse 類別實作了可插拔的網際網路存取協定。

當 WebException 被類別的 WebRequest 後代拋出時，該 Response 屬性會對應用程式提供網際網路回應。

相關建議

檢查例外的回應屬性，以判斷請求失敗的原因。 當 WebException 類別的後代 WebRequest 拋出例外時，該 Response 屬性會提供對應用程式的網際網路回應。

檢查例外的狀態屬性，以判斷請求失敗的原因。 Status例外的屬性提供錯誤的狀態資訊。 如需詳細資訊，請參閱WebExceptionStatus。

如果你在進入 XML Web Service 時會逾時，請將 XML Web Service 呼叫的逾時值設為無限大。 更多資訊請參閱 「錯誤：除錯時逾時」網頁服務。

建構函式

名稱	Description
WebException()	初始化 WebException 類別的新執行個體。
WebException(SerializationInfo, StreamingContext)	已淘汰. 從指定的 SerializationInfo 和 StreamingContext 實例中初始化該類別的新實例WebException。
WebException(String, Exception, WebExceptionStatus, WebResponse)	初始化該類別的新實例 WebException ，並包含指定的錯誤訊息、巢狀例外、狀態與回應。
WebException(String, Exception)	初始化類別的新實例 WebException ，並以指定的錯誤訊息與巢狀例外。
WebException(String, WebExceptionStatus)	初始化一個類別的新實例 WebException ，並以指定的錯誤訊息與狀態。
WebException(String)	初始化該類別的新實例 WebException ，並以指定的錯誤訊息。

屬性

名稱	Description
Data	取得一組鍵值對，提供關於例外的額外使用者定義資訊。 (繼承來源 Exception)
HelpLink	取得或設定與此例外相關的說明檔案連結。 (繼承來源 Exception)
HResult	取得或設定 HRESULT，一個編碼的數值，指派給特定例外。 (繼承來源 Exception)
InnerException	會取得 Exception 造成目前例外的實例。 (繼承來源 Exception)
Message	會收到描述目前例外的訊息。 (繼承來源 Exception)
Response	回覆說遠端主機已回傳。
Source	取得或設定造成錯誤之應用程式或物件的名稱。 (繼承來源 Exception)
StackTrace	會取得呼叫堆疊上即時框架的字串表示。 (繼承來源 Exception)
Status	會收到回覆的狀態。
TargetSite	會取得拋出當前例外的方法。 (繼承來源 Exception)

方法

名稱	Description
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetBaseException()	當在派生類別中被覆寫時，回傳 Exception 是一個或多個後續例外的根因。 (繼承來源 Exception)
GetHashCode()	做為預設哈希函式。 (繼承來源 Object)
GetObjectData(SerializationInfo, StreamingContext)	已淘汰. 在實例中填充 SerializationInfo 序列化所需的 WebException資料。
GetType()	取得目前實例的執行時型態。 (繼承來源 Exception)
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
ToString()	建立並回傳當前例外的字串表示。 (繼承來源 Exception)

事件

名稱	Description
SerializeObjectState	已淘汰. 當例外被序列化以建立包含該例外序列化資料的例外狀態物件時，會發生這種情況。 (繼承來源 Exception)

明確介面實作

名稱	Description
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	將此實例序列化為指定的 SerializationInfo 物件。

另請參閱

• Exception