ArgumentException 建構函式

定義

命名空間:

System

組件:

netstandard.dll, System.Runtime.dll

初始化 ArgumentException 類別的新執行個體。

多載

名稱	Description
ArgumentException()	初始化 ArgumentException 類別的新執行個體。
ArgumentException(String)	初始化類別的新實例 ArgumentException 並指定錯誤訊息。
ArgumentException(SerializationInfo, StreamingContext)	已淘汰. 使用串行化數據，初始化 ArgumentException 類別的新實例。
ArgumentException(String, Exception)	初始化類別的新實例 ArgumentException ，並附上指定的錯誤訊息及導致該異常的內部例外的參考。
ArgumentException(String, String)	初始化一個新的類別實例 ArgumentException ，並以指定的錯誤訊息及引起此例外的參數名稱。
ArgumentException(String, String, Exception)	初始化類別的新實例 ArgumentException ，包含指定的錯誤訊息、參數名稱，以及對導致此異常的內部例外的參考。

ArgumentException()

來源:

ArgumentException.cs

初始化 ArgumentException 類別的新執行個體。

public:
 ArgumentException();

public ArgumentException();

Public Sub New ()

備註

此建構器將新實例的屬性初始 Message 化為系統提供的訊息，描述錯誤，例如「指定了一個無效參數」。此訊息考量了當前系統文化。

下表顯示了 的 ArgumentException初始屬性值。

房產	價值
InnerException	一個空參考（Nothing Visual Basic 中的 Reference）。
Message	區域化錯誤訊息字串。

ArgumentException(String)

來源:

ArgumentException.cs

初始化類別的新實例 ArgumentException 並指定錯誤訊息。

public:
 ArgumentException(System::String ^ message);

public ArgumentException(string? message);

new ArgumentException : string -> ArgumentException

Public Sub New (message As String)

參數

message

String

錯誤訊息解釋了例外原因。

備註

此建構器將新實例的屬性初始 Message 化為系統提供的訊息，描述錯誤，例如「指定了一個無效參數」。此訊息考量了當前系統文化。

下表顯示了 的 ArgumentException初始屬性值。

房產	價值
InnerException	一個空參考（Nothing Visual Basic 中的 Reference）。
Message	錯誤訊息字串。

ArgumentException(SerializationInfo, StreamingContext)

來源:

ArgumentException.cs

警告

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

使用串行化數據，初始化 ArgumentException 類別的新實例。

protected:
 ArgumentException(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 ArgumentException(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}")>]
new ArgumentException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> ArgumentException

Protected Sub New (info As SerializationInfo, context As StreamingContext)

參數

info

SerializationInfo

存放序列化物件資料的物件。

context

StreamingContext

關於來源或目的地的上下文資訊。

屬性

ObsoleteAttribute

備註

此建構子在反序列化過程中被呼叫，以重建透過串流傳輸的例外物件。 欲了解更多資訊，請參閱 XML 與 SOAP 序列化。

另請參閱

• XML 與 SOAP 序列化

ArgumentException(String, Exception)

來源:

ArgumentException.cs

初始化類別的新實例 ArgumentException ，並附上指定的錯誤訊息及導致該異常的內部例外的參考。

public:
 ArgumentException(System::String ^ message, Exception ^ innerException);

public ArgumentException(string? message, Exception? innerException);

new ArgumentException : string * Exception -> ArgumentException

Public Sub New (message As String, innerException As Exception)

參數

message

String

錯誤訊息解釋了例外原因。

innerException

Exception

該例外即為當前例外的原因。 若參數 innerException 非 null 參考，當前例外會在處理內部異常的區塊中被提出 catch 。

備註

此建構子會利用參數值Message初始message化新實例的屬性。 參數的內容 message 是為了讓人類理解而設計的。 此建構器的呼叫者必須確保此字串已在目前系統文化中本地化。

因先前例外直接拋出的例外，應包含對該屬性中 InnerException 先前例外的參考。 該 InnerException 屬性回傳與傳入建構子相同的值，或 null 若該 InnerException 性質未提供內部例外值給建構子。

下表顯示了 的 ArgumentException初始屬性值。

房產	價值
InnerException	內部例外的參考。
Message	區域化錯誤訊息字串。

另請參閱

• Exception
• 處理與拋出例外

ArgumentException(String, String)

來源:

ArgumentException.cs

初始化一個新的類別實例 ArgumentException ，並以指定的錯誤訊息及引起此例外的參數名稱。

public:
 ArgumentException(System::String ^ message, System::String ^ paramName);

public ArgumentException(string? message, string? paramName);

new ArgumentException : string * string -> ArgumentException

Public Sub New (message As String, paramName As String)

參數

message

String

錯誤訊息解釋了例外原因。

paramName

String

造成目前例外的參數名稱。

範例

以下程式碼範例示範如何呼叫建 ArgumentException 構子。 此程式碼範例是本類別更大範例 ArgumentException 的一部分。

static int DivideByTwo(int num)
{
    // If num is an odd number, throw an ArgumentException.
    if ((num & 1) == 1)
        throw new ArgumentException("Number must be even", "num");

    // num is even, return half of its value.
    return num / 2;
}

let divideByTwo num =
    // If num is an odd number, raise an ArgumentException.
    if num % 2 = 1 then
        raise (ArgumentException("num", "Number must be even"))

    // num is even, return half of its value.
    num / 2;

備註

此建構子會利用參數值Message初始message化新實例的屬性。 參數的內容 message 是為了讓人類理解而設計的。 此建構器的呼叫者必須確保此字串已在目前系統文化中本地化。

此建構子會使用初始ParamName化paramName新實例的屬性。 內容 paramName 是為了讓人類理解。

下表顯示了 的 ArgumentException初始屬性值。

房產	價值
Message	錯誤訊息字串。
ParamName	參數名稱字串。

ArgumentException(String, String, Exception)

來源:

ArgumentException.cs

初始化類別的新實例 ArgumentException ，包含指定的錯誤訊息、參數名稱，以及對導致此異常的內部例外的參考。

public:
 ArgumentException(System::String ^ message, System::String ^ paramName, Exception ^ innerException);

public ArgumentException(string? message, string? paramName, Exception? innerException);

new ArgumentException : string * string * Exception -> ArgumentException

Public Sub New (message As String, paramName As String, innerException As Exception)

參數

message

String

錯誤訊息解釋了例外原因。

paramName

String

造成目前例外的參數名稱。

innerException

Exception

該例外即為當前例外的原因。 若參數 innerException 非 null 參考，當前例外會在處理內部異常的區塊中被提出 catch 。

備註

此建構子會利用參數值Message初始message化新實例的屬性。 參數的內容 message 是為了讓人類理解而設計的。 此建構器的呼叫者必須確保此字串已在目前系統文化中本地化。

此建構子會使用初始ParamName化paramName新實例的屬性。 內容 paramName 是為了讓人類理解。

因先前例外直接拋出的例外，應包含對該屬性中 InnerException 先前例外的參考。 該 InnerException 屬性回傳與傳入建構子相同的值，或 null 若該 InnerException 性質未提供內部例外值給建構子。

下表顯示了 的 ArgumentException初始屬性值。

房產	價值
InnerException	內部例外的參考。
Message	區域化錯誤訊息字串。
ParamName	參數名稱字串。

另請參閱

• Exception
• 處理與拋出例外