ArgumentNullException Класс

Определение

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

System

Сборки:

netstandard.dll, System.Runtime.dll

Исходный код:

ArgumentNullException.cs

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

public ref class ArgumentNullException : ArgumentException

public class ArgumentNullException : ArgumentException

type ArgumentNullException = class
    inherit ArgumentException

Public Class ArgumentNullException
Inherits ArgumentException

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

Object

Exception

SystemException

ArgumentException

ArgumentNullException

Комментарии

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

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

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

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

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

ArgumentNullException использует E_POINTER HRESULT, которая имеет значение 0x80004003.

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

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

Имя	Описание
ArgumentNullException()	Инициализирует новый экземпляр класса ArgumentNullException.
ArgumentNullException(SerializationInfo, StreamingContext)	Устаревшие.. Инициализирует новый экземпляр ArgumentNullException класса сериализованными данными.
ArgumentNullException(String, Exception)	Инициализирует новый экземпляр ArgumentNullException класса с указанным сообщением об ошибке и исключением, которое является причиной этого исключения.
ArgumentNullException(String, String)	Инициализирует экземпляр ArgumentNullException класса с указанным сообщением об ошибке и именем параметра, вызывающего это исключение.
ArgumentNullException(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 if argumentnull.
ThrowIfNull(Void*, String)	Создает исключение ArgumentNullException if argumentnull.
ToString()	Создает и возвращает строковое представление текущего исключения. (Унаследовано от Exception)

События

Имя	Описание
SerializeObjectState	Устаревшие.. Происходит при сериализации исключения для создания объекта состояния исключения, содержащего сериализованные данные об исключении. (Унаследовано от Exception)

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

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