ArgumentNullException 类

定义

当将 null 引用(Visual Basic 中为 Nothing)传递到不接受其作为有效参数的方法时引发的异常。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.

在以下两个主要情况下, 将在运行时引发异常,这两个情况均反映开发人员错误:ArgumentNullExceptionAn 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.

  • 然后, 从方法调用返回的对象作为参数传递给第二个方法, 但原始返回对象的值为nullAn 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. 有关由非空参数引起的错误,请参见 ArgumentOutOfRangeExceptionFor errors caused by arguments that are not null, see ArgumentOutOfRangeException.

ArgumentNullException使用 E_POINTER 值为0x80004003 的 HRESULT。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)

适用于

另请参阅