ArgumentException コンストラクター

定義

ArgumentException クラスの新しいインスタンスを初期化します。Initializes a new instance of the ArgumentException class.

オーバーロード

ArgumentException()

ArgumentException クラスの新しいインスタンスを初期化します。Initializes a new instance of the ArgumentException class.

ArgumentException(String)

指定したエラー メッセージを使用して、ArgumentException クラスの新しいインスタンスを初期化します。Initializes a new instance of the ArgumentException class with a specified error message.

ArgumentException(SerializationInfo, StreamingContext)

シリアル化したデータを使用して、ArgumentException クラスの新しいインスタンスを初期化します。Initializes a new instance of the ArgumentException class with serialized data.

ArgumentException(String, Exception)

指定したエラー メッセージおよびこの例外の原因となった内部例外への参照を使用して、ArgumentException クラスの新しいインスタンスを初期化します。Initializes a new instance of the ArgumentException class with a specified error message and a reference to the inner exception that is the cause of this exception.

ArgumentException(String, String)

エラー メッセージ、およびこの例外の原因であるパラメーターの名前を指定して、ArgumentException クラスの新しいインスタンスを初期化します。Initializes a new instance of the ArgumentException class with a specified error message and the name of the parameter that causes this exception.

ArgumentException(String, String, Exception)

エラー メッセージ、パラメーター名、およびこの例外の原因である内部例外への参照を指定して、ArgumentException クラスの新しいインスタンスを初期化します。Initializes a new instance of the ArgumentException class with a specified error message, the parameter name, and a reference to the inner exception that is the cause of this exception.

ArgumentException()

ArgumentException クラスの新しいインスタンスを初期化します。Initializes a new instance of the ArgumentException class.

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

注釈

このコンストラクターは、 Message 新しいインスタンスのプロパティを、"無効な引数が指定されました。" などのエラーを説明するシステム提供のメッセージに初期化します。This constructor initializes the Message property of the new instance to a system-supplied message that describes the error, such as "An invalid argument was specified." このメッセージには、システムの現在のカルチャが考慮されます。This message takes into account the current system culture.

次の表に、ArgumentException のインスタンスに対するプロパティの初期値を示します。The following table shows the initial property values for an instance of ArgumentException.

プロパティProperty Value
InnerException null 参照 (Visual Basic の場合は Nothing)。A null reference (Nothing in Visual Basic).
Message ローカライズされたエラー メッセージ文字列。The localized error message string.

適用対象

ArgumentException(String)

指定したエラー メッセージを使用して、ArgumentException クラスの新しいインスタンスを初期化します。Initializes a new instance of the ArgumentException class with a specified error message.

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

パラメーター

message
String

例外の原因を説明するエラー メッセージ。The error message that explains the reason for the exception.

注釈

このコンストラクターは、 Message 新しいインスタンスのプロパティを、"無効な引数が指定されました。" などのエラーを説明するシステム提供のメッセージに初期化します。This constructor initializes the Message property of the new instance to a system-supplied message that describes the error, such as "An invalid argument was specified." このメッセージには、システムの現在のカルチャが考慮されます。This message takes into account the current system culture.

次の表に、ArgumentException のインスタンスに対するプロパティの初期値を示します。The following table shows the initial property values for an instance of ArgumentException.

プロパティProperty Value
InnerException null 参照 (Visual Basic の場合は Nothing)。A null reference (Nothing in Visual Basic).
Message エラー メッセージ文字列。The error message string.

適用対象

ArgumentException(SerializationInfo, StreamingContext)

シリアル化したデータを使用して、ArgumentException クラスの新しいインスタンスを初期化します。Initializes a new instance of the ArgumentException class with serialized data.

protected:
 ArgumentException(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);
protected ArgumentException (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
new ArgumentException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> ArgumentException
Protected Sub New (info As SerializationInfo, context As StreamingContext)

パラメーター

info
SerializationInfo

シリアル化されたオブジェクト データを保持するオブジェクト。The object that holds the serialized object data.

context
StreamingContext

転送元または転送先に関するコンテキスト情報。The contextual information about the source or destination.

注釈

このコンストラクターは、シリアル化解除の際に呼び出されて、ストリームで送信された例外オブジェクトを再構成します。This constructor is called during deserialization to reconstitute the exception object transmitted over a stream. 詳細については、「 XML および SOAP シリアル化」を参照してください。For more information, see XML and SOAP Serialization.

こちらもご覧ください

適用対象

ArgumentException(String, Exception)

指定したエラー メッセージおよびこの例外の原因となった内部例外への参照を使用して、ArgumentException クラスの新しいインスタンスを初期化します。Initializes a new instance of the ArgumentException class with a specified error message and a reference to the inner exception that is the cause of this exception.

public:
 ArgumentException(System::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

例外の原因を説明するエラー メッセージ。The error message that explains the reason for the exception.

innerException
Exception

現在の例外の原因となった例外。The exception that is the cause of the current exception. innerException パラメーターが null 参照でない場合は、内部例外を処理する catch ブロックで現在の例外が発生します。If the innerException parameter is not a null reference, the current exception is raised in a catch block that handles the inner exception.

注釈

このコンストラクターは、 Message パラメーターの値を使用して、新しいインスタンスのプロパティを初期化し message ます。This constructor initializes the Message property of the new instance using the value of the message parameter. message パラメーターの内容は、ユーザーが理解できる内容にします。The content of the message parameter is intended to be understood by humans. このコンストラクターの呼び出し元は、この文字列が現在のシステム環境向けにローカライズされていることを確認する必要があります。The caller of this constructor is required to ensure that this string has been localized for the current system culture.

前の例外の直接の結果としてスローされる例外については、InnerException プロパティに、前の例外への参照を含める必要があります。An exception that is thrown as a direct result of a previous exception should include a reference to the previous exception in the InnerException property. InnerException プロパティは、コンストラクターに渡されるのと同じ値を返します。または、InnerException プロパティがコンストラクターに内部例外値を提供しない場合には null を返します。The InnerException property returns the same value that is passed into the constructor, or null if the InnerException property does not supply the inner exception value to the constructor.

次の表に、ArgumentException のインスタンスに対するプロパティの初期値を示します。The following table shows the initial property values for an instance of ArgumentException.

プロパティProperty [値]Value
InnerException 内部例外の参照。The inner exception reference.
Message ローカライズされたエラー メッセージ文字列。The localized error message string.

こちらもご覧ください

適用対象

ArgumentException(String, String)

エラー メッセージ、およびこの例外の原因であるパラメーターの名前を指定して、ArgumentException クラスの新しいインスタンスを初期化します。Initializes a new instance of the ArgumentException class with a specified error message and the name of the parameter that causes this exception.

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

パラメーター

message
String

例外の原因を説明するエラー メッセージ。The error message that explains the reason for the exception.

paramName
String

例外の原因となったパラメーターの名前。The name of the parameter that caused the current exception.

次のコード例は、コンストラクターを呼び出す方法を示して ArgumentException います。The following code example demonstrates how to call the ArgumentException constructor. このコード例は、ArgumentException クラスのために提供されている大規模な例の一部です。This code example is part of a larger example provided for the ArgumentException class.

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

注釈

このコンストラクターは、 Message パラメーターの値を使用して、新しいインスタンスのプロパティを初期化し message ます。This constructor initializes the Message property of the new instance using the value of the message parameter. message パラメーターの内容は、ユーザーが理解できる内容にします。The content of the message parameter is intended to be understood by humans. このコンストラクターの呼び出し元は、この文字列が現在のシステム環境向けにローカライズされていることを確認する必要があります。The caller of this constructor is required to ensure that this string has been localized for the current system culture.

このコンストラクターは、 ParamName を使用して、新しいインスタンスのプロパティを初期化し paramName ます。This constructor initializes the ParamName property of the new instance using paramName. paramName の内容は、ユーザーが理解できる内容にします。The content of paramName is intended to be understood by humans.

次の表に、ArgumentException のインスタンスに対するプロパティの初期値を示します。The following table shows the initial property values for an instance of ArgumentException.

プロパティProperty Value
Message エラー メッセージ文字列。The error message string.
ParamName パラメーター名の文字列。The parameter name string.

適用対象

ArgumentException(String, String, Exception)

エラー メッセージ、パラメーター名、およびこの例外の原因である内部例外への参照を指定して、ArgumentException クラスの新しいインスタンスを初期化します。Initializes a new instance of the ArgumentException class with a specified error message, the parameter name, and a reference to the inner exception that is the cause of this exception.

public:
 ArgumentException(System::String ^ message, System::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

例外の原因を説明するエラー メッセージ。The error message that explains the reason for the exception.

paramName
String

例外の原因となったパラメーターの名前。The name of the parameter that caused the current exception.

innerException
Exception

現在の例外の原因となった例外。The exception that is the cause of the current exception. innerException パラメーターが null 参照でない場合は、内部例外を処理する catch ブロックで現在の例外が発生します。If the innerException parameter is not a null reference, the current exception is raised in a catch block that handles the inner exception.

注釈

このコンストラクターは、 Message パラメーターの値を使用して、新しいインスタンスのプロパティを初期化し message ます。This constructor initializes the Message property of the new instance using the value of the message parameter. message パラメーターの内容は、ユーザーが理解できる内容にします。The content of the message parameter is intended to be understood by humans. このコンストラクターの呼び出し元は、この文字列が現在のシステム環境向けにローカライズされていることを確認する必要があります。The caller of this constructor is required to ensure that this string has been localized for the current system culture.

このコンストラクターは、 ParamName を使用して、新しいインスタンスのプロパティを初期化し paramName ます。This constructor initializes the ParamName property of the new instance using paramName. paramName の内容は、ユーザーが理解できる内容にします。The content of paramName is intended to be understood by humans.

前の例外の直接の結果としてスローされる例外については、InnerException プロパティに、前の例外への参照を含める必要があります。An exception that is thrown as a direct result of a previous exception should include a reference to the previous exception in the InnerException property. InnerException プロパティは、コンストラクターに渡されるのと同じ値を返します。または、InnerException プロパティがコンストラクターに内部例外値を提供しない場合には null を返します。The InnerException property returns the same value that is passed into the constructor, or null if the InnerException property does not supply the inner exception value to the constructor.

次の表に、ArgumentException のインスタンスに対するプロパティの初期値を示します。The following table shows the initial property values for an instance of ArgumentException.

プロパティProperty [値]Value
InnerException 内部例外の参照。The inner exception reference.
Message ローカライズされたエラー メッセージ文字列。The localized error message string.
ParamName パラメーター名の文字列。The parameter name string.

こちらもご覧ください

適用対象