エクスポート (0) 印刷
すべて展開
情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

ArgumentOutOfRangeException クラス

2013/12/12

呼び出されたメソッドで定義されている許容範囲外の値が引数として渡された場合にスローされる例外。

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

Namespace:  System
アセンブリ:  mscorlib (mscorlib.dll 内)

public class ArgumentOutOfRangeException : ArgumentException

ArgumentOutOfRangeException 型で公開されるメンバーは以下のとおりです。

  名前説明
パブリック メソッドArgumentOutOfRangeException()ArgumentOutOfRangeException クラスの新しいインスタンスを初期化します。
パブリック メソッドArgumentOutOfRangeException(String)この例外の原因であるパラメーターの名前を使用して、ArgumentOutOfRangeException クラスの新しいインスタンスを初期化します。
パブリック メソッドArgumentOutOfRangeException(String, Exception)指定したエラー メッセージと、この例外の原因である例外を使用して、ArgumentOutOfRangeException クラスの新しいインスタンスを初期化します。
パブリック メソッドArgumentOutOfRangeException(String, String)指定したエラー メッセージと、この例外の原因であるパラメーターの名前を使用して、ArgumentOutOfRangeException クラスの新しいインスタンスを初期化します。
パブリック メソッドArgumentOutOfRangeException(String, Object, String)パラメーターの名前、引数の値、および指定したエラー メッセージを使用して、ArgumentOutOfRangeException クラスの新しいインスタンスを初期化します。
このページのトップへ

  名前説明
パブリック プロパティActualValueこの例外の原因である引数値を取得します。
パブリック プロパティData例外に関する追加のユーザー定義情報を提供するキー/値ペアのコレクションを取得します。 (Exception から継承されます。)
パブリック プロパティHelpLink例外に関連付けられているヘルプ ファイルへのリンクを取得または設定します。 (Exception から継承されます。)
パブリック プロパティHResult特定の例外に割り当てられているコード化数値である HRESULT を取得または設定します。 (Exception から継承されます。)
パブリック プロパティInnerException現在の例外の原因となる Exception インスタンスを取得します。 (Exception から継承されます。)
パブリック プロパティMessageエラー メッセージおよび無効な引数値の文字列形式を取得します。引数値が null の場合は、エラー メッセージだけを取得します。 (ArgumentException.Message をオーバーライドします。)
パブリック プロパティParamNameこの例外の原因である引数の名前を取得します。 (ArgumentException から継承されます。)
パブリック プロパティSourceエラーの原因となったアプリケーションまたはオブジェクトの名前を取得または設定します。 (Exception から継承されます。)
パブリック プロパティStackTrace現在の例外がスローされたときの、コール スタックのフレームの文字列形式を取得します。 (Exception から継承されます。)
このページのトップへ

  名前説明
パブリック メソッドEquals(Object)指定した Object が、現在の Object と等しいかどうかを判断します。 (Object から継承されます。)
プロテクト メソッドFinalizeObject がガベージ コレクションで再利用される前に、Object がリソースを解放して他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
パブリック メソッドGetBaseException派生クラスでオーバーライドされた場合、それ以後に発生する 1 つ以上の例外の主要な原因である Exception を返します。 (Exception から継承されます。)
パブリック メソッドGetHashCode特定の型のハッシュ関数として機能します。 (Object から継承されます。)
パブリック メソッドGetType現在のインスタンスのランタイム型を取得します。 (Exception から継承されます。)
プロテクト メソッドMemberwiseClone現在の Object の簡易コピーを作成します。 (Object から継承されます。)
パブリック メソッドToString現在の例外の文字列形式を作成して返します。 (Exception から継承されます。)
このページのトップへ

ArgumentOutOfRangeException は、メソッドの呼び出し時に渡された引数の少なくとも 1 つが null でなく、有効な値も含まれていない場合にスローされます。

ArgumentOutOfRangeException は、幅広く次のクラスによって使用されます。

ArgumentOutOfRangeException は、ArgumentException と同じように動作します。この例外は、null 以外の無効な引数が原因で発生した例外と null 引数が原因で発生した例外をアプリケーション コードで区別できるようにするために提供されます。null 引数が原因で発生するエラーについては、ArgumentNullException のトピックを参照してください。

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

招待されたゲストに関する情報を含むクラスを定義する例を次に示します。ゲストが 21 歳未満の場合、ArgumentOutOfRangeException 例外がスローされます。

メモメモ:

この例を実行するには、「Windows Phone での静的 TextBlock コントロールのあるコード例のビルド」を参照してください。


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


Windows Phone OS

サポート: 8.0, 7.1, 7.0

この型のすべてのパブリック static (Visual Basic では Shared) メンバーは、スレッド セーフです。インスタンス メンバーの場合は、スレッド セーフであるとは限りません。

表示:
© 2015 Microsoft