ArgumentOutOfRangeException Конструкторы

Определение

Инициализирует новый экземпляр класса ArgumentOutOfRangeException.Initializes a new instance of the ArgumentOutOfRangeException class.

Перегрузки

ArgumentOutOfRangeException()

Инициализирует новый экземпляр класса ArgumentOutOfRangeException.Initializes a new instance of the ArgumentOutOfRangeException class.

ArgumentOutOfRangeException(String)

Инициализирует новый экземпляр класса ArgumentOutOfRangeException именем параметра, вызвавшего исключение.Initializes a new instance of the ArgumentOutOfRangeException class with the name of the parameter that causes this exception.

ArgumentOutOfRangeException(SerializationInfo, StreamingContext)

Инициализирует новый экземпляр класса ArgumentOutOfRangeException с сериализованными данными.Initializes a new instance of the ArgumentOutOfRangeException class with serialized data.

ArgumentOutOfRangeException(String, Exception)

Инициализирует новый экземпляр класса ArgumentOutOfRangeException с заданным сообщением об ошибке и ссылкой на внутреннее исключение, которое стало причиной данного исключения.Initializes a new instance of the ArgumentOutOfRangeException class with a specified error message and the exception that is the cause of this exception.

ArgumentOutOfRangeException(String, String)

Инициализирует новый экземпляр класса ArgumentOutOfRangeException с именем параметра, ставшего причиной этого исключения, и указанным сообщением об ошибке.Initializes a new instance of the ArgumentOutOfRangeException class with the name of the parameter that causes this exception and a specified error message.

ArgumentOutOfRangeException(String, Object, String)

Инициализирует новый экземпляр класса ArgumentOutOfRangeException с именем параметра, значением аргумента и указанным сообщением об ошибке.Initializes a new instance of the ArgumentOutOfRangeException class with the parameter name, the value of the argument, and a specified error message.

ArgumentOutOfRangeException()

Инициализирует новый экземпляр класса ArgumentOutOfRangeException.Initializes a new instance of the ArgumentOutOfRangeException class.

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

Комментарии

Этот конструктор инициализирует Message свойство нового экземпляра, сопоставляя с ним системное сообщение, описывающее ошибку, например «неотрицательное число не требуется».This constructor initializes the Message property of the new instance to a system-supplied message that describes the error, such as "Nonnegative number required." Это сообщение учитывает культуру текущей системы.This message takes into account the current system culture.

В следующей таблице показаны первоначальные значения свойств для экземпляра ArgumentOutOfRangeException.The following table shows the initial property values for an instance of ArgumentOutOfRangeException.

СвойствоProperty ЗначениеValue
InnerException Пустая ссылка (Nothing в Visual Basic).A null reference (Nothing in Visual Basic).
Message Строка локализованного сообщения об ошибке.The localized error message string.

Применяется к

Продукт Introduced

ArgumentOutOfRangeException(String)

Инициализирует новый экземпляр класса ArgumentOutOfRangeException именем параметра, вызвавшего исключение.Initializes a new instance of the ArgumentOutOfRangeException class with the name of the parameter that causes this exception.

public:
 ArgumentOutOfRangeException(System::String ^ paramName);
public ArgumentOutOfRangeException (string paramName);
new ArgumentOutOfRangeException : string -> ArgumentOutOfRangeException
Public Sub New (paramName As String)

Параметры

paramName
String

Имя параметра, ставшего причиной этого исключения.The name of the parameter that causes this exception.

Комментарии

Этот конструктор инициализирует Message свойство нового экземпляра, сопоставляя с ним системное сообщение, описывающее ошибку, например «неотрицательное число не требуется».This constructor initializes the Message property of the new instance to a system-supplied message that describes the error, such as "Nonnegative number required." Это сообщение учитывает культуру текущей системы.This message takes into account the current system culture.

Этот конструктор инициализирует свойство ParamName нового экземпляра, используя параметр paramName.This constructor initializes the ParamName property of the new instance using the paramName parameter. Содержимое paramName должно быть понятно пользователю.The content of paramName is intended to be understood by humans.

В следующей таблице показаны первоначальные значения свойств для экземпляра ArgumentOutOfRangeException.The following table shows the initial property values for an instance of ArgumentOutOfRangeException.

СвойствоProperty ЗначениеValue
InnerException Пустая ссылка (Nothing в Visual Basic).A null reference (Nothing in Visual Basic).
Message Пустая строка ("").The empty string ("").
ParamName Строка имени параметра.The parameter name string.

Применяется к

Продукт Introduced

ArgumentOutOfRangeException(SerializationInfo, StreamingContext)

Инициализирует новый экземпляр класса ArgumentOutOfRangeException с сериализованными данными.Initializes a new instance of the ArgumentOutOfRangeException class with serialized data.

protected:
 ArgumentOutOfRangeException(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);
protected ArgumentOutOfRangeException (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
new ArgumentOutOfRangeException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> ArgumentOutOfRangeException
Protected Sub New (info As SerializationInfo, context As StreamingContext)

Параметры

info
SerializationInfo

Объект, содержащий сериализованные данные объекта.The object that holds the serialized object data.

context
StreamingContext

Объект, описывающий источник или цель сериализованных данных.An object that describes the source or destination of the serialized data.

Комментарии

Этот конструктор вызывается во время десериализации для восстановления объекта исключения, переданного в потоке.This constructor is called during deserialization to reconstitute the exception object transmitted over a stream. Дополнительные сведения см. в разделе сериализация XML и SOAP.For more information, see XML and SOAP Serialization.

См. также раздел

Применяется к

Продукт Introduced

ArgumentOutOfRangeException(String, Exception)

Инициализирует новый экземпляр класса ArgumentOutOfRangeException с заданным сообщением об ошибке и ссылкой на внутреннее исключение, которое стало причиной данного исключения.Initializes a new instance of the ArgumentOutOfRangeException class with a specified error message and the exception that is the cause of this exception.

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

Сообщение об ошибке с объяснением причины исключения.The error message that explains the reason for this exception.

innerException
Exception

Исключение, вызвавшее текущее исключение, или пустая ссылка (Nothing в Visual Basic), если внутреннее исключение не задано.The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified.

Применяется к

Продукт Introduced

ArgumentOutOfRangeException(String, String)

Инициализирует новый экземпляр класса ArgumentOutOfRangeException с именем параметра, ставшего причиной этого исключения, и указанным сообщением об ошибке.Initializes a new instance of the ArgumentOutOfRangeException class with the name of the parameter that causes this exception and a specified error message.

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

Имя параметра, вызвавшего данное исключение.The name of the parameter that caused the exception.

message
String

Сообщение, описывающее ошибку.The message that describes the error.

Комментарии

Этот конструктор инициализирует Message свойство нового экземпляра, используя значение message параметра.This constructor initializes the Message property of the new instance using the value of the message parameter. Содержимое параметра message должно быть понятно пользователям.The content of the message parameter is intended to be understood by humans. Для гарантированной локализации этой строки для текущей системной культуры необходимы сведения о том, кто вызывает этот конструктор.The caller of this constructor is required to ensure that this string has been localized for the current system culture.

Этот конструктор инициализирует свойство ParamName нового экземпляра, используя параметр paramName.This constructor initializes the ParamName property of the new instance using the paramName parameter. Содержимое paramName должно быть понятно пользователю.The content of paramName is intended to be understood by humans.

В следующей таблице показаны первоначальные значения свойств для экземпляра ArgumentOutOfRangeException.The following table shows the initial property values for an instance of ArgumentOutOfRangeException.

СвойствоProperty ЗначениеValue
InnerException null.null.
Message Строка сообщения об ошибке.The error message string.
ParamName Строка имени параметра.The parameter name string.

Применяется к

Продукт Introduced

ArgumentOutOfRangeException(String, Object, String)

Инициализирует новый экземпляр класса ArgumentOutOfRangeException с именем параметра, значением аргумента и указанным сообщением об ошибке.Initializes a new instance of the ArgumentOutOfRangeException class with the parameter name, the value of the argument, and a specified error message.

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

Имя параметра, вызвавшего данное исключение.The name of the parameter that caused the exception.

actualValue
Object

Значение аргумента, вызвавшего данное исключение.The value of the argument that causes this exception.

message
String

Сообщение, описывающее ошибку.The message that describes the error.

Комментарии

Этот конструктор инициализирует ParamName свойство нового экземпляра paramName , используя параметр, ActualValue свойство, используя параметр actualValue , и Message свойство, используя message параметр.This constructor initializes the ParamName property of the new instance using the paramName parameter, the ActualValue property using the actualValue parameter, and the Message property using the message parameter. Содержимое paramName message параметров и должно быть понятным для людей.The content of the paramName and message parameters is intended to be understood by humans. Вызывающий объект этого конструктора необходим, чтобы обеспечить локализацию этих строк для текущего языка и региональных параметров системы.The caller of this constructor is required to ensure that these strings have been localized for the current system culture.

actualValueПараметр не используется в библиотеке классов .NET Framework.The actualValue parameter is not used within the .NET Framework class library. Однако ActualValue свойство предоставляется таким образом, чтобы приложения могли использовать значение доступного аргумента.However, the ActualValue property is provided so that applications can use the available argument value.

actualValueПараметр содержит недопустимое значение, которое передается в метод и вызывает исключение.The actualValue parameter contains an invalid value that is passed to the method and causes this exception to be thrown. Это значение хранится в ActualValue свойстве, а его строковое представление добавляется к строке сообщения, содержащейся в Message свойстве.This value is stored in the ActualValue property and its string representation is appended to the message string held in the Message property.

В следующей таблице показаны первоначальные значения свойств для экземпляра ArgumentOutOfRangeException.The following table shows the initial property values for an instance of ArgumentOutOfRangeException.

СвойствоProperty ЗначениеValue
ActualValue Значение аргумента.The argument value.
InnerException Пустая ссылка ( Nothing в Visual Basic).The null reference (Nothing in Visual Basic).
Message Строка сообщения об ошибке.The error message string.
ParamName Строка имени параметра.The parameter name string.

Применяется к

Продукт Introduced