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()

Исходный код:

ArgumentOutOfRangeException.cs

Инициализирует новый экземпляр класса ArgumentOutOfRangeException.

public:
 ArgumentOutOfRangeException();

public ArgumentOutOfRangeException ();

Public Sub New ()

Комментарии

Этот конструктор инициализирует Message свойство нового экземпляра системным сообщением, описывающим ошибку, например "Требуется неизрицательное число". В этом сообщении учитывается текущий язык и региональные параметры системы.

В следующей таблице показаны первоначальные значения свойств для экземпляра ArgumentOutOfRangeException.

Свойство	Значение
InnerException	Пустая ссылка (Nothing в Visual Basic).
Message	Строка локализованного сообщения об ошибке.

ArgumentOutOfRangeException(String)

Исходный код:

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.

Свойство	Значение
InnerException	Пустая ссылка (Nothing в Visual Basic).
Message	Пустая строка ("").
ParamName	Строка имени параметра.

ArgumentOutOfRangeException(SerializationInfo, StreamingContext)

Исходный код:

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)

Исходный код:

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

Исключение, вызвавшее текущее исключение, или пустая ссылка (Nothing в Visual Basic), если внутреннее исключение не задано.

ArgumentOutOfRangeException(String, String)

Исходный код:

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.

Свойство	Значение
InnerException	null.
Message	Строка сообщения об ошибке.
ParamName	Строка имени параметра.

ArgumentOutOfRangeException(String, Object, String)

Исходный код:

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 свойство нового экземпляра с помощью paramName параметра , ActualValue свойство с помощью actualValue параметра и Message свойство с помощью message параметра . Содержимое paramName параметров и message предназначено для понимания людьми. Вызывающий объект этого конструктора необходим, чтобы убедиться, что эти строки были локализованы для текущего системного языка и региональных параметров.

Параметр actualValue не используется в библиотеке классов .NET. Однако приложения могут использовать ActualValue свойство для получения доступного значения аргумента.

Параметр actualValue содержит недопустимое значение, которое было передано методу и вызвало исключение. Это значение хранится в свойстве ActualValue , а его строковое представление добавляется к строке сообщения, хранящейся в свойстве Message .

В следующей таблице показаны первоначальные значения свойств для экземпляра ArgumentOutOfRangeException.

Свойство	Значение
ActualValue	Значение аргумента.
InnerException	Пустая ссылка (Nothing в Visual Basic).
Message	Строка сообщения об ошибке.
ParamName	Строка имени параметра.