ArgumentNullException ArgumentNullException ArgumentNullException ArgumentNullException Class

Определение

Исключение, которое выбрасывается, при передаче указателя 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
Наследование
Атрибуты

Комментарии

ArgumentNullException Исключение вызывается, когда вызывается метод и хотя бы один из переданных аргументов является null , но никогда не должно быть null.An 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 аргументы и исключений, вызванных аргументами, которые не являются пустыми.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 использует E_POINTER HRESULT, которое имеет значение 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() ArgumentNullException() ArgumentNullException()

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

ArgumentNullException(SerializationInfo, StreamingContext) ArgumentNullException(SerializationInfo, StreamingContext) ArgumentNullException(SerializationInfo, StreamingContext) ArgumentNullException(SerializationInfo, StreamingContext)

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

ArgumentNullException(String) ArgumentNullException(String) ArgumentNullException(String) 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(String, Exception) ArgumentNullException(String, 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(String, String) ArgumentNullException(String, String) 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.

Методы

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
GetBaseException() GetBaseException() GetBaseException() GetBaseException()

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

(Inherited from Exception)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext)

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

(Inherited from ArgumentException)
GetType() GetType() GetType() GetType()

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

(Inherited from Exception)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
ToString() ToString() ToString() ToString()

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

(Inherited from Exception)

Свойства

Data Data Data Data

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

(Inherited from Exception)
HelpLink HelpLink HelpLink HelpLink

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

(Inherited from Exception)
HResult HResult HResult HResult

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

(Inherited from Exception)
InnerException InnerException InnerException InnerException

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

(Inherited from Exception)
Message Message Message Message

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

(Inherited from ArgumentException)
ParamName ParamName ParamName ParamName

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

(Inherited from ArgumentException)
Source Source Source Source

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

(Inherited from Exception)
StackTrace StackTrace StackTrace StackTrace

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

(Inherited from Exception)
TargetSite TargetSite TargetSite TargetSite

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

(Inherited from Exception)

События

SerializeObjectState SerializeObjectState SerializeObjectState SerializeObjectState

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

(Inherited from Exception)

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

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