Represents the error that occurs when an argument passed to a method is invalid.

See Also: ArgumentException Members

System.Object
     System.Exception
          System.SystemException
               System.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

ArgumentException is thrown when a method is invoked and at least one of the passed arguments does not meet the method's parameter specification.

Note:

The Base Class Library includes three derived types:

• ArgumentNullException
• ArgumentOutOfRangeException
• DuplicateWaitObjectException

When appropriate, use these types instead of ArgumentException.

Example

The following example demonstrates an error that causes a ArgumentException exception to be thrown by the system.

C# Example

using System;
public class MyClass {}
public class ArgExceptionExample {
  public static void Main() {
    MyClass my = new MyClass();
    string s = "sometext";
    try {
       int i = s.CompareTo(my);
    }
    catch (ArgumentException e) {
       Console.WriteLine("Error: {0}",e);
    }
  }
}
   

The output is

Error: System.ArgumentException: Object must be of type String.
at System.String.CompareTo(Object value)
at ArgExceptionExample.Main()

Requirements

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