导出 (0) 打印
全部展开
此文章由机器翻译。 将光标移到文章的句子上,以查看原文。 更多信息。
译文
原文

ArgumentOutOfRangeException 类

当参数值超出调用的方法所定义的允许取值范围时引发的异常。

System.Object
  System.Exception
    System.SystemException
      System.ArgumentException
        System.ArgumentOutOfRangeException

命名空间:  System
程序集:  mscorlib(在 mscorlib.dll 中)

[SerializableAttribute]
[ComVisibleAttribute(true)]
public class ArgumentOutOfRangeException : ArgumentException, 
	ISerializable

ArgumentOutOfRangeException 类型公开以下成员。

  名称说明
公共方法由 XNA Framework 提供支持受 可移植类库 支持受 适用于 Windows 应用商店应用的 .NET 支持ArgumentOutOfRangeException()初始化 ArgumentOutOfRangeException 类的新实例。
公共方法由 XNA Framework 提供支持受 可移植类库 支持受 适用于 Windows 应用商店应用的 .NET 支持ArgumentOutOfRangeException(String)使用导致此异常的参数的名称初始化 ArgumentOutOfRangeException 类的新实例。
受保护的方法ArgumentOutOfRangeException(SerializationInfo, StreamingContext)用序列化数据初始化 ArgumentOutOfRangeException 类的新实例。
公共方法受 可移植类库 支持受 适用于 Windows 应用商店应用的 .NET 支持ArgumentOutOfRangeException(String, Exception)使用指定的错误消息和引发此异常的异常初始化 ArgumentOutOfRangeException 类的新实例。
公共方法由 XNA Framework 提供支持受 可移植类库 支持受 适用于 Windows 应用商店应用的 .NET 支持ArgumentOutOfRangeException(String, String)使用指定的错误消息和导致此异常的参数的名称来初始化 ArgumentOutOfRangeException 类的新实例。
公共方法受 可移植类库 支持受 适用于 Windows 应用商店应用的 .NET 支持ArgumentOutOfRangeException(String, Object, String)使用指定的错误消息、参数名和参数值来初始化 ArgumentOutOfRangeException 类的新实例。
页首

  名称说明
公共属性受 可移植类库 支持受 适用于 Windows 应用商店应用的 .NET 支持ActualValue获取导致此异常的参数值。
公共属性受 可移植类库 支持受 适用于 Windows 应用商店应用的 .NET 支持Data获取一个提供用户定义的其他异常信息的键/值对的集合。 (继承自 Exception。)
公共属性受 可移植类库 支持受 适用于 Windows 应用商店应用的 .NET 支持HelpLink获取或设置指向此异常所关联帮助文件的链接。 (继承自 Exception。)
公共属性由 XNA Framework 提供支持受 可移植类库 支持受 适用于 Windows 应用商店应用的 .NET 支持HResult获取或设置 HRESULT(一个分配给特定异常的编码数字值)。 (继承自 Exception。)
公共属性由 XNA Framework 提供支持受 可移植类库 支持受 适用于 Windows 应用商店应用的 .NET 支持InnerException获取导致当前异常的 Exception 实例。 (继承自 Exception。)
公共属性由 XNA Framework 提供支持Message获取错误消息和无效参数值的字符串表示形式;或者,如果该参数值为 null,则仅获取错误消息。 (重写 ArgumentException.Message。)

在 XNA Framework 3.0 中,此成员继承自 Exception.Message
公共属性受 可移植类库 支持受 适用于 Windows 应用商店应用的 .NET 支持ParamName获取导致该异常的参数的名称。 (继承自 ArgumentException。)
公共属性受 可移植类库 支持受 适用于 Windows 应用商店应用的 .NET 支持Source获取或设置导致错误的应用程序或对象的名称。 (继承自 Exception。)
公共属性由 XNA Framework 提供支持受 可移植类库 支持受 适用于 Windows 应用商店应用的 .NET 支持StackTrace获取调用堆栈上直接帧的字符串表示形式。 (继承自 Exception。)
公共属性TargetSite获取引发当前异常的方法。 (继承自 Exception。)
页首

  名称说明
公共方法由 XNA Framework 提供支持受 可移植类库 支持受 适用于 Windows 应用商店应用的 .NET 支持Equals(Object)确定指定的对象是否等于当前对象。 (继承自 Object。)
受保护的方法由 XNA Framework 提供支持受 可移植类库 支持受 适用于 Windows 应用商店应用的 .NET 支持Finalize允许对象在“垃圾回收”回收之前尝试释放资源并执行其他清理操作。 (继承自 Object。)
公共方法由 XNA Framework 提供支持受 可移植类库 支持受 适用于 Windows 应用商店应用的 .NET 支持GetBaseException当在派生类中重写时,返回 Exception,它是一个或多个并发的异常的根源。 (继承自 Exception。)
公共方法由 XNA Framework 提供支持受 可移植类库 支持受 适用于 Windows 应用商店应用的 .NET 支持GetHashCode作为默认哈希函数。 (继承自 Object。)
公共方法GetObjectData设置带有无效参数值和附加异常信息的 SerializationInfo 对象。 (重写 ArgumentException.GetObjectData(SerializationInfo, StreamingContext)。)
公共方法由 XNA Framework 提供支持受 可移植类库 支持受 适用于 Windows 应用商店应用的 .NET 支持GetType获取当前实例的运行时类型。 (继承自 Exception。)

在 XNA Framework 3.0 中,此成员继承自 Object.GetType()


在 可移植类库 可移植类库 中,此成员继承自 Object.GetType()


在 适用于 Windows 应用商店应用的 .NET Windows 8 中,此成员继承自 Object.GetType()
受保护的方法由 XNA Framework 提供支持受 可移植类库 支持受 适用于 Windows 应用商店应用的 .NET 支持MemberwiseClone创建当前 Object 的浅表副本。 (继承自 Object。)
公共方法由 XNA Framework 提供支持受 可移植类库 支持受 适用于 Windows 应用商店应用的 .NET 支持ToString创建并返回当前异常的字符串表示形式。 (继承自 Exception。)
页首

  名称说明
受保护的事件SerializeObjectState在序列化异常,以创建包含有关异常的序列化数据的异常状态对象时发生。 (继承自 Exception。)
页首

当调用某个方法时,如果在传递给该方法的参数中至少有一个不为null 且不包含有效值,则将引发 ArgumentOutOfRangeException

ArgumentOutOfRangeException 为以下类所广泛使用:

ArgumentOutOfRangeException 的行为与 ArgumentException 的行为相同。 提供该类的目的是:应用程序代码可以区分由不为 null 的无效参数引起的异常以及 null 参数引起的异常。 有关 null 参数引起的错误,请参见 ArgumentNullException

ArgumentOutOfRangeException 使用值为 0x80131502 的 HRESULT COR_E_ARGUMENTOUTOFRANGE。

有关 ArgumentOutOfRangeException 实例的初始属性值列表,请参见 ArgumentOutOfRangeException 构造函数。

下面的示例定义了一个类,并在类中包含有关受邀请来宾的信息。 如果来宾小于 21 岁,则会引发 ArgumentOutOfRangeException 异常。


using System;

class Program
{
    static void Main(string[] args)
    {
        try
        {
            Guest guest1 = new Guest("Ben", "Miller", 17);
            Console.WriteLine(guest1.GuestInfo());
        }
        catch (ArgumentOutOfRangeException outOfRange)
        {

            Console.WriteLine("Error: {0}", outOfRange.Message);
        }
    }
}

class Guest
{
    private string FirstName;
    private string LastName;
    private int Age;

    public Guest(string fName, string lName, int age)
    {
        FirstName = fName;
        LastName = lName;
        if (age < 21)
            throw new ArgumentOutOfRangeException("age","All guests must be 21-years-old or older.");
        else
            Age = age;
    }

    public string GuestInfo()
    {
        string gInfo = FirstName + " " + LastName + ", " + Age.ToString();
        return(gInfo);
    }
}


.NET Framework

受以下版本支持:4.5.2、4.5.1、4.5、4、3.5、3.0、2.0、1.1、1.0

.NET Framework Client Profile

受以下版本支持:4、3.5 SP1

可移植类库

受以下版本支持:可移植类库

适用于 Windows 应用商店应用的 .NET

受以下版本支持:Windows 8

适用于 Windows Phone 应用的 .NET

受以下版本支持:Windows Phone 8、Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008(不支持服务器核心角色), Windows Server 2008 R2(支持带 SP1 或更高版本的服务器核心角色;不支持 Itanium)

.NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参阅.NET Framework 系统要求

此类型的任何公共 static(在 Visual Basic 中为 Shared) 成员都是线程安全的。但不保证所有实例成员都是线程安全的。

社区附加资源

添加
显示:
© 2014 Microsoft