ArgumentNullException 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
当将 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当调用方法并且至少一个传递的参数为 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) |
如果 为 |
ThrowIfNull(Void*, String) |
如果 为 |
ToString() |
创建并返回当前异常的字符串表示形式。 (继承自 Exception) |
事件
SerializeObjectState |
已过时.
当异常被序列化用来创建包含有关该异常的徐列出数据的异常状态对象时会出现该问题。 (继承自 Exception) |