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

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

ArgumentException.cs

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

public:
 ArgumentException();

public ArgumentException ();

Public Sub New ()

Комментарии

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

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

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

ArgumentException(String)

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

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.

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

ArgumentException(SerializationInfo, StreamingContext)

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

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)

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

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 не является указателем NULL, текущее исключение возникло в блоке catch, обрабатывающем внутреннее исключение.

Комментарии

Этот конструктор инициализирует Message свойство нового экземпляра, используя значение message параметра . Содержимое параметра message должно быть понятно пользователям. Для гарантированной локализации этой строки для текущей системной культуры необходимы сведения о том, кто вызывает этот конструктор.

Исключение, созданное как прямой результат предыдущего исключения, должно содержать в свойстве InnerException ссылку на предыдущее исключение. Свойство InnerException возвращает то же значение, которое передается в конструктор, или null, если свойство InnerException не предоставляет значение внутреннего исключения в конструктор.

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

Свойство	Значение
InnerException	Ссылка на внутреннее исключение.
Message	Строка локализованного сообщения об ошибке.

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

• Exception
• Обработка и создание исключений

ArgumentException(String, String)

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

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.

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

ArgumentException(String, String, Exception)

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

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 не является указателем NULL, текущее исключение возникло в блоке catch, обрабатывающем внутреннее исключение.

Комментарии

Этот конструктор инициализирует Message свойство нового экземпляра, используя значение message параметра . Содержимое параметра message должно быть понятно пользователям. Для гарантированной локализации этой строки для текущей системной культуры необходимы сведения о том, кто вызывает этот конструктор.

Этот конструктор инициализирует ParamName свойство нового экземпляра с помощью paramName. Содержимое paramName должно быть понятно пользователю.

Исключение, созданное как прямой результат предыдущего исключения, должно содержать в свойстве InnerException ссылку на предыдущее исключение. Свойство InnerException возвращает то же значение, которое передается в конструктор, или null, если свойство InnerException не предоставляет значение внутреннего исключения в конструктор.

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

Свойство	Значение
InnerException	Ссылка на внутреннее исключение.
Message	Строка локализованного сообщения об ошибке.
ParamName	Строка имени параметра.

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

• Exception
• Обработка и создание исключений