ArgumentNullException Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Исключение, которое создается при передаче пустой ссылки (Nothing в Visual Basic) методу, который не принимает ее как допустимый аргумент.
public ref class ArgumentNullException : ArgumentExceptionpublic class ArgumentNullException : ArgumentException[System.Serializable]
public class ArgumentNullException : ArgumentException[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class ArgumentNullException : ArgumentExceptiontype ArgumentNullException = class
inherit ArgumentException[<System.Serializable>]
type ArgumentNullException = class
inherit ArgumentException[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type ArgumentNullException = class
inherit ArgumentExceptionPublic Class ArgumentNullException
Inherits ArgumentException- Наследование
- Наследование
- Атрибуты
Комментарии
Исключение 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 если |
| ThrowIfNull(Void*, String) |
Создает исключение , ArgumentNullException если |
| ToString() |
Создает и возвращает строковое представление текущего исключения. (Унаследовано от Exception) |
События
| SerializeObjectState |
Устаревшие..
Возникает, когда исключение сериализовано для создания объекта состояния исключения, содержащего сериализованные данные об исключении. (Унаследовано от Exception) |