ArgumentNullException 建構函式
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
初始化 ArgumentNullException 類別的新執行個體。
多載
ArgumentNullException() |
初始化 ArgumentNullException 類別的新執行個體。 |
ArgumentNullException(String) |
使用造成這個例外狀況的參數名稱來初始化 ArgumentNullException 類別的新執行個體。 |
ArgumentNullException(SerializationInfo, StreamingContext) |
已淘汰.
使用序列化資料,初始化 ArgumentNullException 類別的新執行個體。 |
ArgumentNullException(String, Exception) |
使用指定的錯誤訊息和造成這個例外狀況的例外狀況,初始化 ArgumentNullException 類別的新執行個體。 |
ArgumentNullException(String, String) |
使用指定的錯誤訊息和造成這個例外狀況的參數名稱來初始化 ArgumentNullException 類別的執行個體。 |
ArgumentNullException()
初始化 ArgumentNullException 類別的新執行個體。
public:
ArgumentNullException();
public ArgumentNullException ();
Public Sub New ()
備註
這個建構函式會將 Message 新實例的 屬性初始化為系統提供的訊息,描述錯誤,例如「值不可為 Null」。此訊息會將目前的系統文化特性納入考慮。
下表顯示 ArgumentNullException 執行個體的初始屬性值。
屬性 | 值 |
---|---|
InnerException | null 參考 (在 Visual Basic 中為 Nothing )。 |
Message | 英文的當地語系化錯誤訊息字串,例如「值不可為 Null」。 |
適用於
ArgumentNullException(String)
使用造成這個例外狀況的參數名稱來初始化 ArgumentNullException 類別的新執行個體。
public:
ArgumentNullException(System::String ^ paramName);
public ArgumentNullException (string paramName);
public ArgumentNullException (string? paramName);
new ArgumentNullException : string -> ArgumentNullException
Public Sub New (paramName As String)
參數
- paramName
- String
造成例外狀況的參數名稱。
備註
這個建構函式會將 Message 新實例的 屬性初始化為系統提供的訊息,描述錯誤並包含參數名稱。 此訊息會考慮到目前系統的文化特性。
這個建構函式使用 ParamName 參數來初始化新執行個體的 paramName
屬性。
paramName
的內容必須能讓人了解。
下表顯示 ArgumentNullException 執行個體的初始屬性值。
屬性 | 值 |
---|---|
InnerException | null 參考 (在 Visual Basic 中為 Nothing )。 |
Message | 識別 null 引數的當地語系化錯誤訊息字串。 例如,如果 paramName 引數為 「arg1」,則英文訊息字串為:在 .NET 5+ 和 .NET Core 上: Value cannot be null. (Parameter name: 'arg1') 在.NET Framework: Value cannot be null.\r\nParameter name: arg1 |
ParamName | 參數名稱字串。 |
適用於
ArgumentNullException(SerializationInfo, StreamingContext)
警告
This API supports obsolete formatter-based serialization. It should not be called or extended by application code.
使用序列化資料,初始化 ArgumentNullException 類別的新執行個體。
protected:
ArgumentNullException(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);
protected ArgumentNullException (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected ArgumentNullException (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
[System.Security.SecurityCritical]
protected ArgumentNullException (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
new ArgumentNullException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> ArgumentNullException
[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new ArgumentNullException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> ArgumentNullException
[<System.Security.SecurityCritical>]
new ArgumentNullException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> ArgumentNullException
Protected Sub New (info As SerializationInfo, context As StreamingContext)
參數
- info
- SerializationInfo
存放序列物件資料的物件。
- context
- StreamingContext
物件,描述序列化資料的來源或目的地。
- 屬性
備註
這個建構函式是在還原序列化期間呼叫,以便重新組成透過資料流傳輸的例外狀況物件。 如需詳細資訊,請參閱 < XML 和 SOAP 序列化。
另請參閱
適用於
ArgumentNullException(String, Exception)
使用指定的錯誤訊息和造成這個例外狀況的例外狀況,初始化 ArgumentNullException 類別的新執行個體。
public:
ArgumentNullException(System::String ^ message, Exception ^ innerException);
public ArgumentNullException (string message, Exception innerException);
public ArgumentNullException (string? message, Exception? innerException);
new ArgumentNullException : string * Exception -> ArgumentNullException
Public Sub New (message As String, innerException As Exception)
參數
- message
- String
解釋這個例外狀況原因的錯誤訊息。
- innerException
- Exception
造成目前例外狀況的例外狀況,若未指定內部例外狀況,則為 null 參考 (Visual Basic 中為 Nothing
)。
適用於
ArgumentNullException(String, String)
使用指定的錯誤訊息和造成這個例外狀況的參數名稱來初始化 ArgumentNullException 類別的執行個體。
public:
ArgumentNullException(System::String ^ paramName, System::String ^ message);
public ArgumentNullException (string paramName, string message);
public ArgumentNullException (string? paramName, string? message);
new ArgumentNullException : string * string -> ArgumentNullException
Public Sub New (paramName As String, message As String)
參數
- paramName
- String
造成例外狀況的參數名稱。
- message
- String
描述錯誤的訊息。
備註
這個建構函式會使用 參數的值,初始化 Message 新實例的 message
屬性。
message
參數的內容必須能讓人了解。 需要此建構函式的呼叫者,才能確保此字串已針對目前的系統文化特性進行當地語系化。
這個建構函式使用 ParamName 參數來初始化新執行個體的 paramName
屬性。
paramName
的內容必須能讓人了解。
下表顯示 ArgumentNullException 執行個體的初始屬性值。
屬性 | 值 |
---|---|
InnerException | null 參考 (在 Visual Basic 中為 Nothing )。 |
Message | 錯誤訊息字串。 |
ParamName | 參數名稱字串。 |