• csharp
• vb

Inheritance Hierarchy

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

Syntax

'Declaration
<ComVisibleAttribute(True)> _
Public Class ArgumentOutOfRangeException _
 Inherits ArgumentException

[ComVisibleAttribute(true)]
public class ArgumentOutOfRangeException : ArgumentException

Constructors

Top

Properties

Top

Methods

Top

Remarks

ArgumentOutOfRangeException is thrown when a method is invoked and at least one of the arguments passed to the method is not nulla null reference (Nothing in Visual Basic) and does not contain a valid value.

ArgumentOutOfRangeException is used extensively by:

• Classes in the System.Collections and System.IO namespaces.

• The Array class.

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

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

Examples

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.

Module Example
 Public Sub Demo(ByVal outputBlock As System.Windows.Controls.TextBlock)
 Dim guest1 As Guest = New Guest("Ben", "Miller", 17)
 outputBlock.Text &= guest1.GuestInfo & vbCrLf
 End Sub
 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)
 MyBase.New()
 FirstName = fName
 LastName = lName
 If (age < 21) Then
 Throw New ArgumentOutOfRangeException("age", "All guests must be 21-years-old or older.")
 Else
 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
End Module

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

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Thread Safety

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

See Also

Reference

Other Resources