Поделиться через


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

Определение

Инициализирует новый экземпляр класса 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.cs
Исходный код:
ArgumentException.cs

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

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

Комментарии

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

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

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

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

ArgumentException(String)

Исходный код:
ArgumentException.cs
Исходный код:
ArgumentException.cs
Исходный код:
ArgumentException.cs

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

public:
 ArgumentException(System::String ^ message);
public ArgumentException (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
Исходный код:
ArgumentException.cs
Исходный код:
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);
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);
new ArgumentException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> ArgumentException
[<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

Контекстные сведения об источнике или назначении.

Атрибуты

Комментарии

Этот конструктор вызывается во время десериализации для восстановления объекта исключения, переданного в потоке. Дополнительные сведения см. в разделе Сериализация XML и SOAP.

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

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

ArgumentException(String, Exception)

Исходный код:
ArgumentException.cs
Исходный код:
ArgumentException.cs
Исходный код:
ArgumentException.cs

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

public:
 ArgumentException(System::String ^ message, Exception ^ innerException);
public ArgumentException (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 Строка локализованного сообщения об ошибке.

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

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

ArgumentException(String, String)

Исходный код:
ArgumentException.cs
Исходный код:
ArgumentException.cs
Исходный код:
ArgumentException.cs

Инициализирует новый экземпляр класса ArgumentException с указанным сообщением об ошибке и именем параметра, ставшего причиной этого исключения.

public:
 ArgumentException(System::String ^ message, System::String ^ paramName);
public ArgumentException (string message, 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.cs
Исходный код:
ArgumentException.cs

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

public:
 ArgumentException(System::String ^ message, System::String ^ paramName, Exception ^ innerException);
public ArgumentException (string message, 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 Строка имени параметра.

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

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