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

Определение

Пространство имен:

System

Сборки:

netstandard.dll, 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	Ссылка null (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	Ссылка null (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 Если параметр не является пустой ссылкой, текущее исключение возникает в блоке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 класса.

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

Комментарии

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

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

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

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

Недвижимость	Ценность
InnerException	Ссылка на внутреннее исключение.
Message	Локализованная строка сообщения об ошибке.
ParamName	Строка имени параметра.

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

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