ArgumentException Класс

Определение

Это исключение выбрасывается, если один из передаваемых методу аргументов является недопустимым.

public class ArgumentException : Exception
public class ArgumentException : SystemException
[System.Serializable]
public class ArgumentException : SystemException
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class ArgumentException : SystemException
Наследование
ArgumentException
Наследование
ArgumentException
Производный
Атрибуты
Реализации

Примеры

В следующем примере показано, как создать и перехватить объект ArgumentException. Он использует ArgumentException.GetType(). Свойство Name используется для отображения имени объекта исключения, а также использует Message свойство для отображения текста сообщения об исключении.

using System;

public class Example
{
    static void Main()
    {
        // Define some integers for a division operation.
        int[] values = { 10, 7 };
        foreach (var value in values) {
            try {
               Console.WriteLine("{0} divided by 2 is {1}", value, DivideByTwo(value));
            }
            catch (ArgumentException e) {
               Console.WriteLine("{0}: {1}", e.GetType().Name, e.Message);
            }
            Console.WriteLine();
        }
    }

    static int DivideByTwo(int num)
    {
        // If num is an odd number, throw an ArgumentException.
        if ((num & 1) == 1)
            throw new ArgumentException(String.Format("{0} is not an even number", num),
                                      "num");

        // num is even, return half of its value.
        return num / 2;
    }
}
// This example displays the following output:
//     10 divided by 2 is 5
//
//     ArgumentException: 7 is not an even number
//     Parameter name: num

Комментарии

ArgumentException вызывается при вызове метода и по крайней мере один из переданных аргументов не соответствует спецификации параметра вызываемого метода. Свойство ParamName определяет недопустимый аргумент.

Чаще всего вызывается средой ArgumentException CLR или другой библиотекой классов и указывает на ошибку разработчика. При вызове ArgumentException из кода следует убедиться, что свойство исключения Message содержит понятное сообщение об ошибке, описывающее недопустимый аргумент и ожидаемый диапазон значений аргумента.

Основными производными классами являются ArgumentExceptionArgumentNullException и ArgumentOutOfRangeException. Эти производные классы следует использовать вместо ArgumentException, за исключением ситуаций, когда ни из производных классов не является приемлемым. Например, исключения должны вызываться:

  • ArgumentNullException всякий раз null , когда передается методу, который не принимает его в качестве допустимого аргумента.

  • ArgumentOutOfRangeException если значение аргумента выходит за пределы диапазона допустимых значений; Например, если значение "46" передается в качестве аргумента month во время создания DateTime.

Если в вызове метода нет аргумента или если сбой не связан с самими аргументами, следует InvalidOperationException использовать метод .

ArgumentException использует COR_E_ARGUMENT HRESULT со значением 0x80070057.

Список начальных значений свойств для экземпляра ArgumentException, см. в разделе ArgumentException конструкторы.

В F# можно использовать функцию invalidArg для создания и создания исключение ArgumentException.

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

ArgumentException()

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

ArgumentException(SerializationInfo, StreamingContext)
Устаревшие..

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

ArgumentException(String)

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

ArgumentException(String, Exception)

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

ArgumentException(String, String)

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

ArgumentException(String, String, Exception)

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

Свойства

Data

Возвращает коллекцию пар «ключ-значение», предоставляющую дополнительные сведения об исключении.

(Унаследовано от Exception)
HelpLink

Получает или задает ссылку на файл справки, связанный с этим исключением.

(Унаследовано от Exception)
HResult

Возвращает или задает HRESULT — кодированное числовое значение, присвоенное определенному исключению.

(Унаследовано от Exception)
InnerException

Возвращает экземпляр класса Exception, который вызвал текущее исключение.

(Унаследовано от Exception)
Message

Возвращает сообщение об ошибке и имя параметра или только сообщение об ошибке, если не задан ни один параметр.

ParamName

Возвращает имя параметра, ставшего причиной этого исключения.

Source

Возвращает или задает имя приложения или объекта, вызывавшего ошибку.

(Унаследовано от Exception)
StackTrace

Получает строковое представление непосредственных кадров в стеке вызова.

(Унаследовано от Exception)
TargetSite

Возвращает метод, создавший текущее исключение.

(Унаследовано от Exception)

Методы

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
GetBaseException()

При переопределении в производном классе возвращает исключение Exception, которое является первопричиной одного или нескольких последующих исключений.

(Унаследовано от Exception)
GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetObjectData(SerializationInfo, StreamingContext)
Устаревшие..

Задает объекту SerializationInfo имя параметра и дополнительную информацию об исключении.

GetObjectData(SerializationInfo, StreamingContext)
Устаревшие..

При переопределении в производном классе задает объект SerializationInfo со сведениями об исключении.

(Унаследовано от Exception)
GetType()

Возвращает тип среды выполнения текущего экземпляра.

(Унаследовано от Exception)
MemberwiseClone()

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
ThrowIfNullOrEmpty(String, String)

Создает исключение, если argument параметр имеет значение null или пуст.

ThrowIfNullOrWhiteSpace(String, String)

Создает исключение, если argument имеет nullзначение , пусто или состоит только из символов пробела.

ToString()

Создает и возвращает строковое представление текущего исключения.

(Унаследовано от Exception)

События

SerializeObjectState
Устаревшие..

Возникает, когда исключение сериализовано для создания объекта состояния исключения, содержащего сериализованные данные об исключении.

(Унаследовано от Exception)

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

Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

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