ArgumentNullException Класс

Определение

Исключение, которое выбрасывается, при передаче указателя NULL (Nothing в Visual Basic) методу, который не принимает его как недопустимый аргумент.The exception that is thrown when a null reference (Nothing in Visual Basic) is passed to a method that does not accept it as a valid argument.

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

Комментарии

Исключение возникает, когда вызывается метод и хотя бы один из переданных аргументов имеет значение, null но никогда не должен быть null. ArgumentNullExceptionAn ArgumentNullException exception is thrown when a method is invoked and at least one of the passed arguments is null but should never be null.

ArgumentNullException Исключение вызывается во время выполнения в следующих двух основных обстоятельствах, в которых возникает ошибка разработчика:An ArgumentNullException exception is thrown at run time in the following two major circumstances, both of which reflect developer error:

  • Объект, экземпляр которого не был создан, передается в метод.An uninstantiated object is passed to a method. Чтобы избежать этой ошибки, создайте экземпляр объекта.To prevent the error, instantiate the object.

  • Объект, возвращаемый из вызова метода, затем передается в качестве аргумента второму методу, но значение исходного возвращаемого объекта null—.An object returned from a method call is then passed as an argument to a second method, but the value of the original returned object is null. Чтобы избежать этой ошибки, проверьте возвращаемое значение null и вызовите второй метод только в том случае, если возвращаемое значение не nullравно.To prevent the error, check for a return value that is null and call the second method only if the return value is not null.

Поведение исключения ArgumentNullException аналогично поведению исключенияArgumentException.ArgumentNullException behaves identically to ArgumentException. Он предоставляется таким образом, чтобы код приложения мог отличать исключения, вызванные null аргументами и исключениями, вызванными аргументами, которые не равны NULL.It is provided so that application code can differentiate between exceptions caused by null arguments and exceptions caused by arguments that are not null. Сведения об ошибках, вызванных аргументами, которые не являются пустыми, см. ArgumentOutOfRangeException.For errors caused by arguments that are not null, see ArgumentOutOfRangeException.

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

Список начальных значений свойств для экземпляра ArgumentNullException, см. в разделе ArgumentNullException конструкторы.For a list of initial property values for an instance of ArgumentNullException, see the ArgumentNullException constructors.

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

ArgumentNullException()

Инициализирует новый экземпляр класса ArgumentNullException.Initializes a new instance of the ArgumentNullException class.

ArgumentNullException(SerializationInfo, StreamingContext)

Инициализирует новый экземпляр класса ArgumentNullException с сериализованными данными.Initializes a new instance of the ArgumentNullException class with serialized data.

ArgumentNullException(String)

Инициализирует новый экземпляр класса ArgumentNullException именем параметра, вызвавшего исключение.Initializes a new instance of the ArgumentNullException class with the name of the parameter that causes this exception.

ArgumentNullException(String, Exception)

Инициализирует новый экземпляр класса ArgumentNullException с заданным сообщением об ошибке и ссылкой на внутреннее исключение, которое стало причиной данного исключения.Initializes a new instance of the ArgumentNullException class with a specified error message and the exception that is the cause of this exception.

ArgumentNullException(String, String)

Инициализирует экземпляр класса ArgumentNullException с указанным сообщением об ошибке и именем параметра, который является причиной возникновения данного исключения.Initializes an instance of the ArgumentNullException class with a specified error message and the name of the parameter that causes this exception.

Свойства

Data

Возвращает коллекцию пар ключ/значение, предоставляющие дополнительные сведения об исключении, определяемые пользователем.Gets a collection of key/value pairs that provide additional user-defined information about the exception.

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

Получает или задает ссылку на файл справки, связанный с этим исключением.Gets or sets a link to the help file associated with this exception.

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

Возвращает или задает HRESULT — кодированное числовое значение, присвоенное определенному исключению.Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

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

Возвращает экземпляр класса Exception, который вызвал текущее исключение.Gets the Exception instance that caused the current exception.

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

Возвращает сообщение об ошибке и имя параметра или только сообщение об ошибке, если не задан ни один параметр.Gets the error message and the parameter name, or only the error message if no parameter name is set.

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

Возвращает имя параметра, ставшего причиной этого исключения.Gets the name of the parameter that causes this exception.

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

Возвращает или задает имя приложения или объекта, вызывавшего ошибку.Gets or sets the name of the application or the object that causes the error.

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

Получает строковое представление непосредственных кадров в стеке вызова.Gets a string representation of the immediate frames on the call stack.

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

Возвращает метод, создавший текущее исключение.Gets the method that throws the current exception.

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

Методы

Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

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

При переопределении в производном классе возвращает исключение Exception, которое является корневой причиной одного или нескольких последующих исключений.When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

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

Служит хэш-функцией по умолчанию.Serves as the default hash function.

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

Устанавливает SerializationInfo с именем параметра и дополнительными сведениями об исключении.Sets the SerializationInfo object with the parameter name and additional exception information.

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

Возвращает тип среды выполнения текущего экземпляра.Gets the runtime type of the current instance.

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

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

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

Создает и возвращает строковое представление текущего исключения.Creates and returns a string representation of the current exception.

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

События

SerializeObjectState

Возникает, когда исключение сериализовано для создания объекта состояния исключения, содержащего сериализованные данные об исключении.Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

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

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

Дополнительно