ArgumentNullException Класс

Определение

Исключение, которое создается при передаче пустой ссылки (Nothing в Visual Basic) методу, который не принимает ее как допустимый аргумент.

public ref class ArgumentNullException : ArgumentException
public class ArgumentNullException : ArgumentException
[System.Serializable]
public class ArgumentNullException : ArgumentException
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class ArgumentNullException : ArgumentException
type ArgumentNullException = class
    inherit ArgumentException
[<System.Serializable>]
type ArgumentNullException = class
    inherit ArgumentException
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type ArgumentNullException = class
    inherit ArgumentException
Public Class ArgumentNullException
Inherits ArgumentException
Наследование
ArgumentNullException
Наследование
Атрибуты

Комментарии

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

Исключение вызывается ArgumentNullException во время выполнения в следующих двух основных обстоятельствах, в которых возникает ошибка разработчика:

  • Объект, экземпляр которого не был создан, передается в метод. Чтобы избежать этой ошибки, создайте экземпляр объекта.

  • Объект, возвращаемый из вызова метода, затем передается в качестве аргумента второму методу, но значение исходного возвращаемого объекта — null . Чтобы избежать этой ошибки, проверьте возвращаемое значение null и вызовите второй метод только в том случае, если возвращаемое значение не равно null .

Поведение исключения ArgumentNullException аналогично поведению исключенияArgumentException. Он предоставляется таким образом, чтобы код приложения мог отличать исключения, вызванные null аргументами и исключениями, вызванными аргументами, которые не равны NULL. Сведения об ошибках, вызванных аргументами, которые не являются пустыми, см. ArgumentOutOfRangeException.

ArgumentNullException использует E_POINTER HRESULT, имеющий значение 0x80004003.

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

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

ArgumentNullException()

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

ArgumentNullException(SerializationInfo, StreamingContext)

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

ArgumentNullException(String)

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

ArgumentNullException(String, Exception)

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

ArgumentNullException(String, String)

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

Свойства

Data

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Методы

Equals(Object)

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

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

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

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

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

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

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

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

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

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

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

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

Создает исключение, ArgumentNullException Если argument имеет значение null .

ToString()

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

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

События

SerializeObjectState
Является устаревшей.

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

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

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

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