ArgumentException コンストラクター

定義

ArgumentException クラスの新しいインスタンスを初期化します。

オーバーロード

ArgumentException()

ArgumentException クラスの新しいインスタンスを初期化します。

ArgumentException(String)

指定したエラー メッセージを使用して、ArgumentException クラスの新しいインスタンスを初期化します。

ArgumentException(SerializationInfo, StreamingContext)
古い.

シリアル化したデータを使用して、ArgumentException クラスの新しいインスタンスを初期化します。

ArgumentException(String, Exception)

指定したエラー メッセージおよびこの例外の原因となった内部例外への参照を使用して、ArgumentException クラスの新しいインスタンスを初期化します。

ArgumentException(String, String)

エラー メッセージ、およびこの例外の原因であるパラメーターの名前を指定して、ArgumentException クラスの新しいインスタンスを初期化します。

ArgumentException(String, String, Exception)

エラー メッセージ、パラメーター名、およびこの例外の原因である内部例外への参照を指定して、ArgumentException クラスの新しいインスタンスを初期化します。

ArgumentException()

ArgumentException クラスの新しいインスタンスを初期化します。

public:
 ArgumentException();
public ArgumentException ();
Public Sub New ()

注釈

このコンストラクターは、"無効な引数が指定されました" などのエラーを説明するシステム指定のメッセージに対して、新しいインスタンスの プロパティを初期化 Message します。このメッセージでは、現在のシステム カルチャが考慮されます。

次の表に、ArgumentException のインスタンスに対するプロパティの初期値を示します。

プロパティ
InnerException null 参照 (Visual Basic の場合は Nothing)。
Message ローカライズされたエラー メッセージ文字列。

適用対象

ArgumentException(String)

指定したエラー メッセージを使用して、ArgumentException クラスの新しいインスタンスを初期化します。

public:
 ArgumentException(System::String ^ message);
public ArgumentException (string message);
public ArgumentException (string? message);
new ArgumentException : string -> ArgumentException
Public Sub New (message As String)

パラメーター

message
String

例外の原因を説明するエラー メッセージ。

注釈

このコンストラクターは、"無効な引数が指定されました" などのエラーを説明するシステム指定のメッセージに対して、新しいインスタンスの プロパティを初期化 Message します。このメッセージでは、現在のシステム カルチャが考慮されます。

次の表に、ArgumentException のインスタンスに対するプロパティの初期値を示します。

プロパティ
InnerException null 参照 (Visual Basic の場合は Nothing)。
Message エラー メッセージ文字列。

適用対象

ArgumentException(SerializationInfo, StreamingContext)

注意事項

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

シリアル化したデータを使用して、ArgumentException クラスの新しいインスタンスを初期化します。

protected:
 ArgumentException(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);
protected ArgumentException (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected ArgumentException (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
new ArgumentException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> ArgumentException
[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new ArgumentException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> ArgumentException
Protected Sub New (info As SerializationInfo, context As StreamingContext)

パラメーター

info
SerializationInfo

シリアル化されたオブジェクト データを保持するオブジェクト。

context
StreamingContext

転送元または転送先に関するコンテキスト情報。

属性

注釈

このコンストラクターは、シリアル化解除の際に呼び出されて、ストリームで送信された例外オブジェクトを再構成します。 詳細については、「 XML および SOAP のシリアル化」を参照してください。

こちらもご覧ください

適用対象

ArgumentException(String, Exception)

指定したエラー メッセージおよびこの例外の原因となった内部例外への参照を使用して、ArgumentException クラスの新しいインスタンスを初期化します。

public:
 ArgumentException(System::String ^ message, Exception ^ innerException);
public ArgumentException (string message, Exception innerException);
public ArgumentException (string? message, Exception? innerException);
new ArgumentException : string * Exception -> ArgumentException
Public Sub New (message As String, innerException As Exception)

パラメーター

message
String

例外の原因を説明するエラー メッセージ。

innerException
Exception

現在の例外の原因となった例外。 innerException パラメーターが null 参照でない場合は、内部例外を処理する catch ブロックで現在の例外が発生します。

注釈

このコンストラクターは、 パラメーターの値を Message 使用して、新しいインスタンスの プロパティを message 初期化します。 message パラメーターの内容は、ユーザーが理解できる内容にします。 このコンストラクターの呼び出し元は、この文字列が現在のシステム環境向けにローカライズされていることを確認する必要があります。

前の例外の直接の結果としてスローされる例外については、InnerException プロパティに、前の例外への参照を含める必要があります。 InnerException プロパティは、コンストラクターに渡されるのと同じ値を返します。または、InnerException プロパティがコンストラクターに内部例外値を提供しない場合には null を返します。

次の表に、ArgumentException のインスタンスに対するプロパティの初期値を示します。

プロパティ [値]
InnerException 内部例外の参照。
Message ローカライズされたエラー メッセージ文字列。

こちらもご覧ください

適用対象

ArgumentException(String, String)

エラー メッセージ、およびこの例外の原因であるパラメーターの名前を指定して、ArgumentException クラスの新しいインスタンスを初期化します。

public:
 ArgumentException(System::String ^ message, System::String ^ paramName);
public ArgumentException (string message, string paramName);
public ArgumentException (string? message, string? paramName);
new ArgumentException : string * string -> ArgumentException
Public Sub New (message As String, paramName As String)

パラメーター

message
String

例外の原因を説明するエラー メッセージ。

paramName
String

例外の原因となったパラメーターの名前。

次のコード例は、コンストラクターを呼び出す方法を ArgumentException 示しています。 このコード例は、ArgumentException クラスのために提供されている大規模な例の一部です。

int DivideByTwo(int num)
{
    // If num is an odd number, throw an ArgumentException.
    if ((num & 1) == 1)
    {
        throw gcnew ArgumentException("Number must be even", "num");
    }
    // num is even, return half of its value.
    return num / 2;
}
static int DivideByTwo(int num)
{
    // If num is an odd number, throw an ArgumentException.
    if ((num & 1) == 1)
        throw new ArgumentException("Number must be even", "num");

    // num is even, return half of its value.
    return num / 2;
}
let divideByTwo num =
    // If num is an odd number, raise an ArgumentException.
    if num % 2 = 1 then
        raise (ArgumentException("num", "Number must be even"))

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

注釈

このコンストラクターは、 パラメーターの値を Message 使用して、新しいインスタンスの プロパティを message 初期化します。 message パラメーターの内容は、ユーザーが理解できる内容にします。 このコンストラクターの呼び出し元は、この文字列が現在のシステム環境向けにローカライズされていることを確認する必要があります。

このコンストラクターは、 を ParamName 使用して新しいインスタンスの プロパティを paramName初期化します。 paramName の内容は、ユーザーが理解できる内容にします。

次の表に、ArgumentException のインスタンスに対するプロパティの初期値を示します。

プロパティ
Message エラー メッセージ文字列。
ParamName パラメーター名の文字列。

適用対象

ArgumentException(String, String, Exception)

エラー メッセージ、パラメーター名、およびこの例外の原因である内部例外への参照を指定して、ArgumentException クラスの新しいインスタンスを初期化します。

public:
 ArgumentException(System::String ^ message, System::String ^ paramName, Exception ^ innerException);
public ArgumentException (string message, string paramName, Exception innerException);
public ArgumentException (string? message, string? paramName, Exception? innerException);
new ArgumentException : string * string * Exception -> ArgumentException
Public Sub New (message As String, paramName As String, innerException As Exception)

パラメーター

message
String

例外の原因を説明するエラー メッセージ。

paramName
String

例外の原因となったパラメーターの名前。

innerException
Exception

現在の例外の原因となった例外。 innerException パラメーターが null 参照でない場合は、内部例外を処理する catch ブロックで現在の例外が発生します。

注釈

このコンストラクターは、 パラメーターの値を Message 使用して、新しいインスタンスの プロパティを message 初期化します。 message パラメーターの内容は、ユーザーが理解できる内容にします。 このコンストラクターの呼び出し元は、この文字列が現在のシステム環境向けにローカライズされていることを確認する必要があります。

このコンストラクターは、 を ParamName 使用して新しいインスタンスの プロパティを paramName初期化します。 paramName の内容は、ユーザーが理解できる内容にします。

前の例外の直接の結果としてスローされる例外については、InnerException プロパティに、前の例外への参照を含める必要があります。 InnerException プロパティは、コンストラクターに渡されるのと同じ値を返します。または、InnerException プロパティがコンストラクターに内部例外値を提供しない場合には null を返します。

次の表に、ArgumentException のインスタンスに対するプロパティの初期値を示します。

プロパティ [値]
InnerException 内部例外の参照。
Message ローカライズされたエラー メッセージ文字列。
ParamName パラメーター名の文字列。

こちらもご覧ください

適用対象