导出 (0) 打印
全部展开
信息
您所需的主题如下所示。但此主题未包含在此库中。

ArgumentOutOfRangeException 类

2013/12/13

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

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

Namespace:  System
程序集:  mscorlib(位于 mscorlib.dll 中)

public class ArgumentOutOfRangeException : ArgumentException

ArgumentOutOfRangeException 类型公开以下成员。

  名称说明
公共方法ArgumentOutOfRangeException()初始化 ArgumentOutOfRangeException 类的新实例。
公共方法ArgumentOutOfRangeException(String)使用导致此异常的参数的名称初始化 ArgumentOutOfRangeException 类的新实例。
公共方法ArgumentOutOfRangeException(String, Exception)使用指定的错误消息和引发此异常的异常初始化 ArgumentOutOfRangeException 类的新实例。
公共方法ArgumentOutOfRangeException(String, String)使用指定错误消息和导致此异常的参数的名称来初始化 ArgumentOutOfRangeException 类的新实例。
公共方法ArgumentOutOfRangeException(String, Object, String)使用参数名称、参数名和指定的错误消息来初始化 ArgumentOutOfRangeException 类的新实例。
返回顶部

  名称说明
公共属性ActualValue获取导致此异常的参数值。
公共属性Data获取一个提供用户定义的其他异常信息的键/值对的集合。 (从 Exception 继承。)
公共属性HelpLink获取或设置指向此异常所关联帮助文件的链接。 (从 Exception 继承。)
公共属性HResult获取或设置 HRESULT(一个分配给特定异常的编码数字值)。 (从 Exception 继承。)
公共属性InnerException获取导致当前异常的 Exception 实例。 (从 Exception 继承。)
公共属性Message获取错误消息和无效参数值的字符串表示形式;或者,如果该参数值为 null,则仅获取错误消息。 (重写 ArgumentException.Message。)
公共属性ParamName获取导致该异常的参数的名称。 (从 ArgumentException 继承。)
公共属性Source获取或设置导致错误的应用程序或对象的名称。 (从 Exception 继承。)
公共属性StackTrace获取在引发当前异常时调用堆栈上帧的字符串表示形式。 (从 Exception 继承。)
返回顶部

  名称说明
公共方法Equals(Object)确定指定的 Object 是否等于当前的 Object (从 Object 继承。)
受保护的方法Finalize允许 Object 在垃圾回收器回收该对象之前尝试释放资源并执行其他清理操作。 (从 Object 继承。)
公共方法GetBaseException当在派生类中重写时,返回 Exception,它是一个或多个并发的异常的根源。 (从 Exception 继承。)
公共方法GetHashCode用作特定类型的哈希函数。 (从 Object 继承。)
公共方法GetType获取当前实例的运行时类型。 (从 Exception 继承。)
受保护的方法MemberwiseClone创建当前 Object 的浅表副本。 (从 Object 继承。)
公共方法ToString创建并返回当前异常的字符串表示形式。 (从 Exception 继承。)
返回顶部

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

ArgumentOutOfRangeException 为以下类所广泛使用:

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

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

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

说明注意:

要运行此示例,请参见生成具有静态 Windows Phone TextBlock 控件的示例


using System;

class Example
{
   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
   {
      Guest guest1 = new Guest("Ben", "Miller", 17);
      outputBlock.Text += guest1.GuestInfo() + "\n";
   }
}

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);
   }
}


Windows Phone OS

受以下版本支持: 8.0, 7.1, 7.0

Windows Phone

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

显示:
© 2014 Microsoft