ArgumentNullException Класс

Определение

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

System

Сборка:

System.Runtime.dll

Сборка:

mscorlib.dll

Сборка:

netstandard.dll

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

C#

public class ArgumentNullException : ArgumentException

C#

[System.Serializable]
public class ArgumentNullException : ArgumentException

C#

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class ArgumentNullException : ArgumentException

Наследование

Object

Exception

ArgumentException

ArgumentNullException

Наследование

Object

Exception

SystemException

ArgumentException

ArgumentNullException

Атрибуты

SerializableAttribute ComVisibleAttribute

Комментарии

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

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

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

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

Поведение исключения ArgumentNullException аналогично поведению исключенияArgumentException. Он предоставляется для того, чтобы код приложения мог различать исключения, вызванные 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.
ThrowIfNull(Void*, String)	Создает исключение , ArgumentNullException если argument имеет значение null.
ToString()	Создает и возвращает строковое представление текущего исключения. (Унаследовано от Exception)

События

SerializeObjectState

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

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

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

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