ArgumentException ArgumentException ArgumentException ArgumentException Constructors

Определение

Перегрузки

ArgumentException() ArgumentException() ArgumentException()

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

ArgumentException(String) ArgumentException(String) ArgumentException(String) ArgumentException(String)

Инициализирует новый экземпляр класса ArgumentException с указанным сообщением об ошибке.Initializes a new instance of the ArgumentException class with a specified error message.

ArgumentException(SerializationInfo, StreamingContext) ArgumentException(SerializationInfo, StreamingContext) ArgumentException(SerializationInfo, StreamingContext) ArgumentException(SerializationInfo, StreamingContext)

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

ArgumentException(String, Exception) ArgumentException(String, Exception) ArgumentException(String, Exception) ArgumentException(String, Exception)

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

ArgumentException(String, String) ArgumentException(String, String) ArgumentException(String, String) ArgumentException(String, String)

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

ArgumentException(String, String, Exception) ArgumentException(String, String, Exception) ArgumentException(String, String, Exception) ArgumentException(String, String, Exception)

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

ArgumentException() ArgumentException() ArgumentException()

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

public:
 ArgumentException();
public ArgumentException ();
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 "An invalid argument was specified." Это сообщение учитывает текущую культуру системы.This message takes into account the current system culture.

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

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

ArgumentException(String) ArgumentException(String) ArgumentException(String) ArgumentException(String)

Инициализирует новый экземпляр класса ArgumentException с указанным сообщением об ошибке.Initializes a new instance of the ArgumentException class with a specified error message.

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

Параметры

message
String String String String

Сообщение об ошибке, указывающее причину создания исключения.The error message that explains the reason for the exception.

Комментарии

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

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

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

ArgumentException(SerializationInfo, StreamingContext) ArgumentException(SerializationInfo, StreamingContext) ArgumentException(SerializationInfo, StreamingContext) ArgumentException(SerializationInfo, StreamingContext)

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

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

Параметры

info
SerializationInfo SerializationInfo SerializationInfo SerializationInfo

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

context
StreamingContext StreamingContext StreamingContext StreamingContext

Контекстные сведения об источнике или назначении.The contextual information about the source or destination.

Комментарии

Данный конструктор вызывается в процессе десериализации для воссоздания объекта исключения, переданного в потоке.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.

Дополнительно

ArgumentException(String, Exception) ArgumentException(String, Exception) ArgumentException(String, Exception) ArgumentException(String, Exception)

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

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 String String String

Сообщение об ошибке, указывающее причину создания исключения.The error message that explains the reason for the exception.

innerException
Exception Exception Exception Exception

Исключение, которое является причиной текущего исключения.The exception that is the cause of the current exception. Если параметр innerException не является указателем NULL, текущее исключение возникло в блоке catch, обрабатывающем внутреннее исключение.If the innerException parameter is not a null reference, the current exception is raised in a catch block that handles the inner exception.

Комментарии

Этот конструктор инициализирует 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.

Исключение, созданное как прямой результат предыдущего исключения, должно содержать в свойстве InnerException ссылку на предыдущее исключение.An exception that is thrown as a direct result of a previous exception should include a reference to the previous exception in the InnerException property. Свойство InnerException возвращает значение, переданное конструктору, или значение null, если свойство InnerException не передает конструктору значение внутреннего исключения.The InnerException property returns the same value that is passed into the constructor, or null if the InnerException property does not supply the inner exception value to the constructor.

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

Свойство.Property ЗначениеValue
InnerException Ссылка на внутреннее исключения.The inner exception reference.
Message Строка локализованного сообщения об ошибке.The localized error message string.
Дополнительно

ArgumentException(String, String) ArgumentException(String, String) ArgumentException(String, String) ArgumentException(String, String)

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

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 String String String

Сообщение об ошибке, указывающее причину создания исключения.The error message that explains the reason for the exception.

paramName
String String String String

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

Примеры

В следующем примере кода показано, как вызвать ArgumentException конструктор.The following code example demonstrates how to call the ArgumentException constructor. Этот пример кода является частью большого примера, ArgumentException приведенного для класса.This code example is part of a larger example provided for the ArgumentException class.

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;
}

Комментарии

Этот конструктор инициализирует 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 paramName. Содержимое параметра paramName должно быть понятным пользователю.The content of paramName is intended to be understood by humans.

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

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

ArgumentException(String, String, Exception) ArgumentException(String, String, Exception) ArgumentException(String, String, Exception) ArgumentException(String, String, Exception)

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

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 String String String

Сообщение об ошибке, указывающее причину создания исключения.The error message that explains the reason for the exception.

paramName
String String String String

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

innerException
Exception Exception Exception Exception

Исключение, которое является причиной текущего исключения.The exception that is the cause of the current exception. Если параметр innerException не является указателем NULL, текущее исключение возникло в блоке catch, обрабатывающем внутреннее исключение.If the innerException parameter is not a null reference, the current exception is raised in a catch block that handles the inner exception.

Комментарии

Этот конструктор инициализирует 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 paramName. Содержимое параметра paramName должно быть понятным пользователю.The content of paramName is intended to be understood by humans.

Исключение, созданное как прямой результат предыдущего исключения, должно содержать в свойстве InnerException ссылку на предыдущее исключение.An exception that is thrown as a direct result of a previous exception should include a reference to the previous exception in the InnerException property. Свойство InnerException возвращает значение, переданное конструктору, или значение null, если свойство InnerException не передает конструктору значение внутреннего исключения.The InnerException property returns the same value that is passed into the constructor, or null if the InnerException property does not supply the inner exception value to the constructor.

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

Свойство.Property ЗначениеValue
InnerException Ссылка на внутреннее исключения.The inner exception reference.
Message Строка локализованного сообщения об ошибке.The localized error message string.
ParamName Строка имени параметра.The parameter name string.
Дополнительно

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