共用方式為


ArgumentException 建構函式

定義

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

多載

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.cs
來源:
ArgumentException.cs

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

public:
 ArgumentException();
public ArgumentException ();
Public Sub New ()

備註

這個建構函式會將 Message 新實例的 屬性初始化為系統提供的訊息,描述錯誤,例如「指定了不正確引數」。此訊息會將目前的系統文化特性納入考慮。

下表顯示 ArgumentException 執行個體的初始屬性值。

屬性
InnerException null 參考 (在 Visual Basic 中為 Nothing)。
Message 當地語系化的錯誤訊息字串。

適用於

ArgumentException(String)

來源:
ArgumentException.cs
來源:
ArgumentException.cs
來源:
ArgumentException.cs

使用指定的錯誤訊息,初始化 ArgumentException 類別的新執行個體。

public:
 ArgumentException(System::String ^ message);
public ArgumentException (string message);
public ArgumentException (string? message);
new ArgumentException : string -> ArgumentException
Public Sub New (message As String)

參數

message
String

解釋例外狀況原因的錯誤訊息。

備註

這個建構函式會將 Message 新實例的 屬性初始化為系統提供的訊息,描述錯誤,例如「指定了不正確引數」。此訊息會將目前的系統文化特性納入考慮。

下表顯示 ArgumentException 執行個體的初始屬性值。

屬性
InnerException null 參考 (在 Visual Basic 中為 Nothing)。
Message 錯誤訊息字串。

適用於

ArgumentException(SerializationInfo, StreamingContext)

來源:
ArgumentException.cs
來源:
ArgumentException.cs
來源:
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);
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);
new ArgumentException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> ArgumentException
[<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

關於來源或目的端的內容資訊。

屬性

備註

這個建構函式是在還原序列化期間呼叫,以便重新組成透過資料流傳輸的例外狀況物件。 如需詳細資訊,請參閱 < XML 和 SOAP 序列化

另請參閱

適用於

ArgumentException(String, Exception)

來源:
ArgumentException.cs
來源:
ArgumentException.cs
來源:
ArgumentException.cs

使用指定的錯誤訊息以及造成此例外狀況的內部例外狀況的參考,初始化 ArgumentException 類別的新執行個體。

public:
 ArgumentException(System::String ^ message, Exception ^ innerException);
public ArgumentException (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 當地語系化的錯誤訊息字串。

另請參閱

適用於

ArgumentException(String, String)

來源:
ArgumentException.cs
來源:
ArgumentException.cs
來源:
ArgumentException.cs

使用指定的錯誤訊息和造成這個例外狀況的參數名稱,初始化 ArgumentException 類別的新執行個體。

public:
 ArgumentException(System::String ^ message, System::String ^ paramName);
public ArgumentException (string message, 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 一部分。

int DivideByTwo(int num)
{
    // If num is an odd number, throw an ArgumentException.
    if ((num & 1) == 1)
    {
        throw gcnew ArgumentException("Number must be even", "num");
    }
    // num is even, return half of its value.
    return num / 2;
}
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.cs
來源:
ArgumentException.cs

使用指定的錯誤訊息、參數名稱和造成這個例外狀況原因的內部例外參考,初始化 ArgumentException 類別的新執行個體。

public:
 ArgumentException(System::String ^ message, System::String ^ paramName, Exception ^ innerException);
public ArgumentException (string message, 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 參數名稱字串。

另請參閱

適用於