ArgumentNullException 类

定义

当将 null 引用(Visual Basic 中为 Nothing)传递到不接受其作为有效参数的方法时引发的异常。

public ref class ArgumentNullException : ArgumentException
public class ArgumentNullException : ArgumentException
[System.Serializable]
public class ArgumentNullException : ArgumentException
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class ArgumentNullException : ArgumentException
type ArgumentNullException = class
    inherit ArgumentException
[<System.Serializable>]
type ArgumentNullException = class
    inherit ArgumentException
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type ArgumentNullException = class
    inherit ArgumentException
Public Class ArgumentNullException
Inherits ArgumentException
继承
ArgumentNullException
继承
属性

注解

ArgumentNullException当调用方法并且至少一个传递的参数为 null 但绝不应为 null时,将引发异常。

ArgumentNullException在以下两种主要情况下,在运行时引发异常,这两种情况都反映了开发人员错误:

  • 未实例化的对象将传递给方法。 若要防止此错误,请实例化 对象。

  • 然后,从方法调用返回的对象作为参数传递给第二个方法,但原始返回对象的 null值为 。 若要防止此错误,请检查返回值是否为 null ,并仅在返回值不 null为 时调用第二个方法。

ArgumentNullException 的行为与 ArgumentException 的行为相同。 提供它,以便应用程序代码可以区分由参数引起的 null 异常和由不为 null 的参数引起的异常。 有关由非空参数引起的错误,请参见 ArgumentOutOfRangeException

ArgumentNullException 使用 HRESULT E_POINTER,其值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)

如果 为 nullArgumentNullExceptionargument引发 。

ThrowIfNull(Void*, String)

如果 为 nullArgumentNullExceptionargument引发 。

ToString()

创建并返回当前异常的字符串表示形式。

(继承自 Exception)

事件

SerializeObjectState
已过时.

当异常被序列化用来创建包含有关该异常的徐列出数据的异常状态对象时会出现该问题。

(继承自 Exception)

适用于

另请参阅