ArgumentException Class

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

Syntax

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

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:

When appropriate, use these types instead of ArgumentException.

Thread Safety

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

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, 4.0.0.0