ArgumentNullException 類別

定義

命名空間:

System

組件:

netstandard.dll, System.Runtime.dll

來源:

ArgumentNullException.cs

當 null 引用Nothing （在 Visual Basic 中）傳給不接受該參數的方法時，拋出的例外。

public ref class ArgumentNullException : ArgumentException

public class ArgumentNullException : ArgumentException

type ArgumentNullException = class
    inherit ArgumentException

Public Class ArgumentNullException
Inherits ArgumentException

繼承

Object

Exception

SystemException

ArgumentException

ArgumentNullException

備註

ArgumentNullException當呼叫方法且至少有一個傳遞參數是 null 但絕不應該是 null時，會拋出例外。

ArgumentNullException執行時會拋出以下兩種主要情況的例外，兩者皆反映開發者錯誤：

• 未實例化的物件會傳遞給一個方法。 為了避免錯誤，請實例化該物件。

• 從方法呼叫回傳的物件會作為參數傳遞給第二個方法，但原始回傳物件的值為 null。 為避免錯誤，請檢查返回值是否為 ， null 只有當返回值不是 null時才呼叫第二個方法。

ArgumentNullException 行為與 完全相同 ArgumentException。 此功能是為了讓應用程式程式能夠區分由 null 參數引起的異常，以及由非空參數引起的異常。 關於非空參數所造成的錯誤，請參見 ArgumentOutOfRangeException。

ArgumentNullException 使用 HRESULT E_POINTER，其值為 0x80004003。

如需查看 ArgumentNullException 實例的初始屬性值列表，請參閱 ArgumentNullException 的建構子。

建構函式

名稱	Description
ArgumentNullException()	初始化 ArgumentNullException 類別的新執行個體。
ArgumentNullException(SerializationInfo, StreamingContext)	已淘汰. 初始化一個新的類別實例 ArgumentNullException ，並使用序列化資料。
ArgumentNullException(String, Exception)	初始化一個新的類別實例 ArgumentNullException ，並以指定的錯誤訊息及導致該例外的例外。
ArgumentNullException(String, String)	初始化類別的實例 ArgumentNullException ，並以指定的錯誤訊息及導致此例外的參數名稱。
ArgumentNullException(String)	初始化一個新的類別實例 ArgumentNullException ，並以引起此例外的參數名稱。

屬性

名稱	Description
Data	取得一組鍵值對，提供關於例外的額外使用者定義資訊。 (繼承來源 Exception)
HelpLink	取得或設定與此例外相關的說明檔案連結。 (繼承來源 Exception)
HResult	取得或設定 HRESULT，一個編碼的數值，指派給特定例外。 (繼承來源 Exception)
InnerException	會取得 Exception 造成目前例外的實例。 (繼承來源 Exception)
Message	會收到錯誤訊息和參數名稱，或者如果沒有設定參數名稱，則只會收到錯誤訊息。 (繼承來源 ArgumentException)
ParamName	取得導致此例外的參數名稱。 (繼承來源 ArgumentException)
Source	取得或設定造成錯誤之應用程式或物件的名稱。 (繼承來源 Exception)
StackTrace	會取得呼叫堆疊上即時框架的字串表示。 (繼承來源 Exception)
TargetSite	會取得拋出當前例外的方法。 (繼承來源 Exception)

方法

名稱	Description
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetBaseException()	當在派生類別中被覆寫時，回傳 Exception 是一個或多個後續例外的根因。 (繼承來源 Exception)
GetHashCode()	做為預設哈希函式。 (繼承來源 Object)
GetObjectData(SerializationInfo, StreamingContext)	已淘汰. 以參數名稱及額外例外資訊設定物件。SerializationInfo (繼承來源 ArgumentException)
GetType()	取得目前實例的執行時型態。 (繼承來源 Exception)
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
ThrowIfNull(Object, String)	擲出 ArgumentNullException 若 argument 是 null。
ThrowIfNull(Void*, String)	擲出 ArgumentNullException 若 argument 是 null。
ToString()	建立並回傳當前例外的字串表示。 (繼承來源 Exception)

事件

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

另請參閱

• Exception
• 處理與拋出例外