This documentation is archived and is not being maintained.

ArgumentOutOfRangeException Class

The exception that is thrown when the value of an argument is outside the allowable range of values as defined by the invoked method.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)

<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public Class ArgumentOutOfRangeException _
	Inherits ArgumentException _
	Implements ISerializable
Dim instance As ArgumentOutOfRangeException

ArgumentOutOfRangeException is thrown when a method is invoked and at least one of the arguments passed to the method is not Nothing and does not contain a valid value.

ArgumentOutOfRangeException is used extensively by:

ArgumentOutOfRangeException behaves identically to ArgumentException. It is provided so that application code can differentiate between exceptions caused by invalid arguments that are not Nothing, and exceptions caused by null arguments. For errors caused by null arguments, see ArgumentNullException.

ArgumentOutOfRangeException uses the HRESULT COR_E_ARGUMENTOUTOFRANGE, which has the value 0x80131502.

For a list of initial property values for an instance of ArgumentOutOfRangeException, see the ArgumentOutOfRangeException constructors.

The following example defines a class to contain information about an invited guest. If the guest is younger than 21, an ArgumentOutOfRangeException exception is thrown.

Imports System

Class Program

    Public Shared Sub Main()
            Dim guest1 As Guest = New Guest("Ben", "Miller", 17)
        Catch outOfRange As Exception
            Console.WriteLine("Error: {0}", outOfRange.Message)
        End Try 
    End Sub 

End Class 

Class Guest

    Private FirstName As String 
    Private LastName As String 

    Private Age As Integer 

    Public Sub New(ByVal fName As String, ByVal lName As String, ByVal age As Integer)
        FirstName = fName
        LastName = lName
        If (age < 21) Then 
            Throw New ArgumentOutOfRangeException("age", "All guests must be 21-years-old or older.")
            age = age
        End If 
    End Sub 

    Public Function GuestInfo() As String 
        Dim gInfo As String = (FirstName + (" " _
                    + (Me.LastName + (", " + Me.Age.ToString))))
        Return gInfo
    End Function 
End Class


Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, 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, Zune

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 3.5, 2.0, 1.0

XNA Framework

Supported in: 3.0, 2.0, 1.0