ArgumentException クラス

定義

public ref class ArgumentException : Exception

public ref class ArgumentException : SystemException

public class ArgumentException : Exception

public class ArgumentException : SystemException

[System.Serializable]
public class ArgumentException : SystemException

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

type ArgumentException = class
    inherit Exception

type ArgumentException = class
    inherit SystemException

type ArgumentException = class
    inherit SystemException
    interface ISerializable

[<System.Serializable>]
type ArgumentException = class
    inherit SystemException
    interface ISerializable

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type ArgumentException = class
    inherit SystemException
    interface ISerializable

Public Class ArgumentException
Inherits Exception

Public Class ArgumentException
Inherits SystemException

継承

Object

Exception

ArgumentException

継承

Object

Exception

SystemException

ArgumentException

派生

System.ArgumentNullException

System.ArgumentOutOfRangeException

System.ComponentModel.InvalidAsynchronousStateException

System.ComponentModel.InvalidEnumArgumentException

System.DuplicateWaitObjectException

その他…

属性

SerializableAttribute ComVisibleAttribute

実装

ISerializable

例

次の例では、 をスローしてキャッチする方法を ArgumentException示します。 ArgumentException.GetType() を使用します。Name プロパティは例外オブジェクトの名前を表示し、 プロパティをMessage使用して例外メッセージのテキストを表示します。

using namespace System;

static int DivideByTwo(int num) 
{
    // If num is an odd number, throw an ArgumentException.
    if ((num & 1) == 1)
        throw gcnew ArgumentException(String::Format("{0} is not an even number", num), 
                                      "num");

    // num is even, return half of its value.
    return num / 2;
}

void main() 
{
    // Define some integers for a division operation.
    array<int>^ values = { 10, 7 };
    for each (int value in values) {
        try {
           Console::WriteLine("{0} divided by 2 is {1}", value, DivideByTwo(value));
        }
        catch (ArgumentException^ e) {
           Console::WriteLine("{0}: {1}", e->GetType()->Name, e->Message);
        }
        Console::WriteLine();
    }
}
// This example displays the following output:
//     10 divided by 2 is 5
//     
//     ArgumentException: 7 is not an even number
//     Parameter name: num

using System;

public class Example
{
    static void Main()
    {
        // Define some integers for a division operation.
        int[] values = { 10, 7 };
        foreach (var value in values) {
            try {
               Console.WriteLine("{0} divided by 2 is {1}", value, DivideByTwo(value));
            }
            catch (ArgumentException e) {
               Console.WriteLine("{0}: {1}", e.GetType().Name, e.Message);
            }
            Console.WriteLine();
        }
    }

    static int DivideByTwo(int num)
    {
        // If num is an odd number, throw an ArgumentException.
        if ((num & 1) == 1)
            throw new ArgumentException(String.Format("{0} is not an even number", num),
                                      "num");

        // num is even, return half of its value.
        return num / 2;
    }
}
// This example displays the following output:
//     10 divided by 2 is 5
//
//     ArgumentException: 7 is not an even number
//     Parameter name: num

open System

let divideByTwo num =
    // If num is an odd number, throw an ArgumentException.
    if num % 2 = 1 then
        invalidArg "num" $"{num} is not an even number"

    // num is even, return half of its value.
    num / 2;

// Define some integers for a division operation.
let values = [ 10; 7 ]
for value in values do
    try 
        printfn $"{value} divided by 2 is {divideByTwo value}"
    with
    | :? ArgumentException as e ->
        printfn $"{e.GetType().Name}: {e.Message}"
    
    printfn ""

// This example displays the following output:
//     10 divided by 2 is 5
//
//     ArgumentException: 7 is not an even number (Parameter 'num')

Public Class Example
    Public Shared Sub Main()
        ' Define some integers for a division operation.
        Dim values() As Integer = { 10, 7 }

        For Each value In values
            Try 
               Console.WriteLine("{0} divided by 2 is {1}", value, DivideByTwo(value))
            Catch e As ArgumentException
               Console.WriteLine("{0}: {1}", e.GetType().Name, e.Message)
            End Try
            Console.WriteLine()
        Next
    End Sub
    
    Private Shared Function DivideByTwo(ByVal num As Integer) As Integer
        ' If num is an odd number, throw an ArgumentException.
        If (num And 1) = 1 Then
            Throw New ArgumentException(String.Format("{0} is not an even number", num), 
                                      "num")
        End If
        Return num \ 2
    End Function
End Class
' The example displays the following output:
'     10 divided by 2 is 5
'     
'     ArgumentException: 7 is not an even number
'     Parameter name: num

注釈

ArgumentException は、メソッドが呼び出され、渡された引数の少なくとも 1 つが、呼び出されたメソッドのパラメーター指定を満たしていない場合にスローされます。 プロパティは ParamName 、無効な引数を識別します。

最も一般的に、 ArgumentException は共通言語ランタイムまたは別のクラス ライブラリによってスローされ、開発者エラーを示します。 コードから を ArgumentException スローする場合は、例外の Message プロパティに、無効な引数と引数の予期される値の範囲を説明する意味のあるエラー メッセージが含まれていることを確認する必要があります。

の主な派生クラスArgumentExceptionは と ArgumentOutOfRangeExceptionですArgumentNullException。 これらの派生クラスは、 の代わりに ArgumentException使用する必要があります。ただし、どちらの派生クラスも許容できない場合を除きます。 たとえば、例外は次の方法でスローする必要があります。

• ArgumentNullException を有効な引数として受け入れないメソッドに渡す場合は常 null に。

• ArgumentOutOfRangeException 引数の値が許容範囲外の場合。たとえば、 の作成時に値 "46" が month 引数として渡された場合などです DateTime。

メソッド呼び出しに引数がない場合、またはエラーに引数自体が含まれていない場合は、 を InvalidOperationException 使用する必要があります。

ArgumentException では、値が0x80070057された HRESULT COR_E_ARGUMENTを使用します。

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

F# では、 invalidArg 関数を使用して ArgumentException を生成および発生させることができます。

コンストラクター

プロパティ

メソッド

イベント

適用対象

こちらもご覧ください

• Exception
• 例外の処理とスロー