ArgumentOutOfRangeException 构造函数

定义

命名空间:

System

程序集:

System.Runtime.dll

初始化 ArgumentOutOfRangeException 类的新实例。

重载

ArgumentOutOfRangeException()	初始化 ArgumentOutOfRangeException 类的新实例。
ArgumentOutOfRangeException(String)	使用导致此异常的参数的名称初始化 ArgumentOutOfRangeException 类的新实例。
ArgumentOutOfRangeException(SerializationInfo, StreamingContext)	已过时. 用序列化数据初始化 ArgumentOutOfRangeException 类的新实例。
ArgumentOutOfRangeException(String, Exception)	使用指定的错误消息和引发此异常的异常初始化 ArgumentOutOfRangeException 类的新实例。
ArgumentOutOfRangeException(String, String)	使用指定的错误消息和导致此异常的参数的名称来初始化 ArgumentOutOfRangeException 类的新实例。
ArgumentOutOfRangeException(String, Object, String)	使用指定的错误消息、参数名和参数值来初始化 ArgumentOutOfRangeException 类的新实例。

ArgumentOutOfRangeException()

Source:

ArgumentOutOfRangeException.cs

初始化 ArgumentOutOfRangeException 类的新实例。

public:
 ArgumentOutOfRangeException();

public ArgumentOutOfRangeException ();

Public Sub New ()

注解

此构造函数将 Message 新实例的 属性初始化为描述错误的系统提供的消息，例如“需要非反数”。此消息考虑了当前系统区域性。

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

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

ArgumentOutOfRangeException(String)

Source:

ArgumentOutOfRangeException.cs

使用导致此异常的参数的名称初始化 ArgumentOutOfRangeException 类的新实例。

public:
 ArgumentOutOfRangeException(System::String ^ paramName);

public ArgumentOutOfRangeException (string? paramName);

new ArgumentOutOfRangeException : string -> ArgumentOutOfRangeException

Public Sub New (paramName As String)

参数

paramName

String

导致此异常的参数的名称。

注解

此构造函数将 Message 新实例的 属性初始化为描述错误的系统提供的消息，例如“需要非反数”。此消息考虑了当前系统区域性。

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

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

properties	值
InnerException	空引用（在 Visual Basic 中为 Nothing）。
Message	空字符串 (“”) 。
ParamName	参数名称字符串。

ArgumentOutOfRangeException(SerializationInfo, StreamingContext)

Source:

ArgumentOutOfRangeException.cs

注意

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

用序列化数据初始化 ArgumentOutOfRangeException 类的新实例。

protected:
 ArgumentOutOfRangeException(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 ArgumentOutOfRangeException (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 ArgumentOutOfRangeException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> ArgumentOutOfRangeException

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

参数

info

SerializationInfo

承载序列化对象数据的对象。

context

StreamingContext

用于描述序列化数据的源或目标的对象。

属性

ObsoleteAttribute

注解

在反序列化期间调用此构造函数以重新构造在流上传输的异常对象。 有关详细信息，请参阅 XML 和 SOAP 序列化。

另请参阅

• XML 和 SOAP 序列化

ArgumentOutOfRangeException(String, Exception)

Source:

ArgumentOutOfRangeException.cs

使用指定的错误消息和引发此异常的异常初始化 ArgumentOutOfRangeException 类的新实例。

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

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

new ArgumentOutOfRangeException : string * Exception -> ArgumentOutOfRangeException

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

参数

message

String

说明发生此异常的原因的错误消息。

innerException

Exception

导致当前异常的异常；如果未指定内部异常，则是一个 null 引用（在 Visual Basic 中为 Nothing）。

ArgumentOutOfRangeException(String, String)

Source:

ArgumentOutOfRangeException.cs

使用指定的错误消息和导致此异常的参数的名称来初始化 ArgumentOutOfRangeException 类的新实例。

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

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

new ArgumentOutOfRangeException : string * string -> ArgumentOutOfRangeException

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

参数

paramName

String

导致异常的参数的名称。

message

String

描述错误的消息。

注解

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

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

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

properties	值
InnerException	null.
Message	错误消息字符串。
ParamName	参数名称字符串。

ArgumentOutOfRangeException(String, Object, String)

Source:

ArgumentOutOfRangeException.cs

使用指定的错误消息、参数名和参数值来初始化 ArgumentOutOfRangeException 类的新实例。

public:
 ArgumentOutOfRangeException(System::String ^ paramName, System::Object ^ actualValue, System::String ^ message);

public ArgumentOutOfRangeException (string? paramName, object? actualValue, string? message);

new ArgumentOutOfRangeException : string * obj * string -> ArgumentOutOfRangeException

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

参数

paramName

String

导致异常的参数的名称。

actualValue

Object

导致此异常的参数值。

message

String

描述错误的消息。

注解

此构造函数使用 参数初始化ParamName新实例的 属性，ActualValue使用 actualValue 参数初始化 属性，Message并使用 参数初始化 message 属性。paramName 和 message 参数的内容paramName旨在由人类理解。 需要此构造函数的调用方来确保这些字符串已针对当前系统区域性进行了本地化。

参数 actualValue 不在 .NET 类库中使用。 但是，应用可以使用 ActualValue 属性来获取可用的参数值。

参数 actualValue 包含传递给 方法并导致引发此异常的无效值。 此值存储在 属性中， ActualValue 其字符串表示形式追加到 属性中 Message 保存的消息字符串。

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

properties	“值”
ActualValue	参数值。
InnerException	Visual Basic) Nothing 中的 null 引用 (。
Message	错误消息字符串。
ParamName	参数名称字符串。