ArgumentException クラス

メソッドに渡された引数のいずれかが無効な場合にスローされる例外。

この型のすべてのメンバの一覧については、ArgumentException メンバ を参照してください。

System.Object
   System.Exception
      System.SystemException
         System.ArgumentException
            System.ArgumentNullException
            System.ArgumentOutOfRangeException
            System.ComponentModel.InvalidEnumArgumentException
            System.DuplicateWaitObjectException

<Serializable>
Public Class ArgumentException   Inherits SystemException
[C#]
[Serializable]
public class ArgumentException : SystemException
[C++]
[Serializable]
public __gc class ArgumentException : public SystemException
[JScript]
public
   Serializable
class ArgumentException extends SystemException

スレッドセーフ

この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。

解説

ArgumentException は、メソッドの呼び出し時に渡された引数の少なくとも 1 つが、呼び出されたメソッドのパラメータの仕様に一致していないとスローされます。 ArgumentException のすべてのインスタンスは、無効な引数と、その引数に指定できる有効な値の範囲を説明する、わかりやすいエラーメッセージを保持する必要があります。

ArgumentException の主要な派生クラスは、 ArgumentNullExceptionArgumentOutOfRangeException です。これらの派生クラスは、両方とも使用できない場合以外は、 ArgumentException の代わりに使用されます。たとえば、次の場合は、それぞれの派生クラスで例外をスローします。

  • null 参照 (Visual Basic では Nothing) を有効な引数として受け付けないメソッドに null 値が渡された場合は、必ず ArgumentNullException を使用します。
  • 指定できる範囲を外れた値が引数として渡された場合は、 ArgumentOutOfRangeException を使用します。たとえば、 DateTime の作成時に、月を指定する引数として "46" という値が渡された場合が該当します。

引数を指定せずにメソッドが呼び出された場合、引数が原因ではないエラーが発生している場合は、 InvalidOperationException を使用します。

ArgumentException は、値 0x80070057 を保持する HRESULT COR_E_ARGUMENT を使用します。

ArgumentException のインスタンスの初期プロパティ値の一覧については、 ArgumentException コンストラクタのトピックを参照してください。

必要条件

名前空間: System

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

アセンブリ: Mscorlib (Mscorlib.dll 内)

参照

ArgumentException メンバ | System 名前空間 | Exception | 例外の処理とスロー