ArgumentException 构造函数

定义

命名空间:

System

程序集:

System.Runtime.dll

初始化 ArgumentException 类的新实例。

重载

ArgumentException()	初始化 ArgumentException 类的新实例。
ArgumentException(String)	用指定的错误消息初始化 ArgumentException 类的新实例。
ArgumentException(SerializationInfo, StreamingContext)	已过时. 用序列化数据初始化 ArgumentException 类的新实例。
ArgumentException(String, Exception)	使用指定的错误消息和对作为此异常原因的内部异常的引用来初始化 ArgumentException 类的新实例。
ArgumentException(String, String)	使用指定的错误消息和导致此异常的参数的名称来初始化 ArgumentException 类的新实例。
ArgumentException(String, String, Exception)	使用指定的错误消息、参数名称和对内部异常的引用（为该异常根源）来初始化 ArgumentException 类的新实例。

ArgumentException()

Source:

ArgumentException.cs

初始化 ArgumentException 类的新实例。

public:
 ArgumentException();

public ArgumentException ();

Public Sub New ()

注解

此构造函数将 Message 新 实例的 属性初始化为系统提供的消息，该消息描述错误，例如“指定的参数无效”。此消息考虑了当前系统区域性。

下表显示了 ArgumentException 实例的初始属性值。

properties	值
InnerException	空引用（在 Visual Basic 中为 Nothing）。
Message	本地化的错误消息字符串。

ArgumentException(String)

Source:

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 实例的初始属性值。

properties	值
InnerException	空引用（在 Visual Basic 中为 Nothing）。
Message	错误消息字符串。

ArgumentException(SerializationInfo, StreamingContext)

Source:

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)

Source:

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 参数不为空引用，则在处理内部异常的 catch 块中引发当前异常。

注解

此构造函数使用 参数的值初始化 Message 新实例的 message 属性。 message 参数的内容应为人所理解。 此构造函数的调用方需要确保此字符串已针对当前系统区域性进行了本地化。

因前一个异常而直接引发的异常应在 InnerException 属性中包含对前一个异常的引用。 InnerException 属性将返回传递给构造函数的同一值；如果 InnerException 属性不向构造函数提供内部异常值，则返回 null。

下表显示了 ArgumentException 实例的初始属性值。

properties	“值”
InnerException	内部异常引用。
Message	本地化的错误消息字符串。

另请参阅

• Exception
• 处理和引发异常

ArgumentException(String, String)

Source:

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 类提供的一个更大示例的一部分。

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 实例的初始属性值。

properties	Value
Message	错误消息字符串。
ParamName	参数名称字符串。

ArgumentException(String, String, Exception)

Source:

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 参数不为空引用，则在处理内部异常的 catch 块中引发当前异常。

注解

此构造函数使用 参数的值初始化 Message 新实例的 message 属性。 message 参数的内容应为人所理解。 此构造函数的调用方需要确保此字符串已针对当前系统区域性进行了本地化。

此构造函数使用 paramName初始化ParamName新实例的 属性。 paramName 的内容设计为易于理解。

因前一个异常而直接引发的异常应在 InnerException 属性中包含对前一个异常的引用。 InnerException 属性将返回传递给构造函数的同一值；如果 InnerException 属性不向构造函数提供内部异常值，则返回 null。

下表显示了 ArgumentException 实例的初始属性值。

properties	“值”
InnerException	内部异常引用。
Message	本地化的错误消息字符串。
ParamName	参数名称字符串。

另请参阅

• Exception
• 处理和引发异常