当调用某个方法时，如果在传递给该方法的参数中至少有一个不为nullNothingnullptrnull 引用（在 Visual Basic 中为 Nothing） 且不包含有效值，则将引发 ArgumentOutOfRangeException。

ArgumentOutOfRangeException 为以下类所广泛使用：

• System.Collections 和 System.IO 命名空间中的类。

• Array 类。

ArgumentOutOfRangeException 的行为与 ArgumentException 相同。提供该类的目的是：应用程序代码可以区分由不为 nullNothingnullptrnull 引用（在 Visual Basic 中为 Nothing） 的无效参数引起的异常以及 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);
    }
}

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC, Xbox 360

.NET Framework

.NET Compact Framework

XNA Framework

参考

其他资源