Represents the error that occurs when an argument passed to a method is invalid because it is outside the allowable range of values as specified by the method. [Edit]

See Also: ArgumentOutOfRangeException Members

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

[System.Runtime.InteropServices.ComVisible(true)] public class ArgumentOutOfRangeException : ArgumentException

Thread Safety

All public static members of this type are safe for multithreaded operations. No instance members are guaranteed to be thread safe.

Remarks

Note:

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

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

[Edit]

Example

The following example demonstrates an error that causes the Array class to throw a ArgumentOutOfRangeException exception.

C# Example

using System; class ArgOutOfRangeExample { public static void Main() { int[] array1 = {0,0}; int[] array2 = {0,0}; try { Array.Copy(array1,array2,-1); } catch (ArgumentOutOfRangeException e) { Console.WriteLine("Error: {0}",e); } } }

The output is

Error: System.ArgumentOutOfRangeException: Non-negative number required.
Parameter name: length
at System.Array.Copy(Array sourceArray, Int32 sourceIndex, Array destinationArray, Int32 destinationIndex, Int32 length)
at ArgOutOfRangeExample.Main()

Requirements

Namespace: System
Assembly: mscorlib (in mscorlib.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0