ArgumentException Konstruktory

Definicja

Przestrzeń nazw:

System

Zestaw:

System.Runtime.dll

Inicjuje nowe wystąpienie klasy ArgumentException.

Przeciążenia

ArgumentException()	Inicjuje nowe wystąpienie klasy ArgumentException.
ArgumentException(String)	Inicjuje ArgumentException nowe wystąpienie klasy z określonym komunikatem o błędzie.
ArgumentException(SerializationInfo, StreamingContext)	Przestarzałe. Inicjuje nowe wystąpienie klasy ArgumentException z zserializowanymi danymi.
ArgumentException(String, Exception)	Inicjuje nowe wystąpienie ArgumentException klasy z określonym komunikatem o błędzie i odwołaniem do wyjątku wewnętrznego, który jest przyczyną tego wyjątku.
ArgumentException(String, String)	Inicjuje nowe wystąpienie ArgumentException klasy z określonym komunikatem o błędzie i nazwą parametru, który powoduje ten wyjątek.
ArgumentException(String, String, Exception)	Inicjuje nowe wystąpienie ArgumentException klasy z określonym komunikatem o błędzie, nazwą parametru i odwołaniem do wewnętrznego wyjątku, który jest przyczyną tego wyjątku.

ArgumentException()

Źródło:

ArgumentException.cs

Inicjuje nowe wystąpienie klasy ArgumentException.

public:
 ArgumentException();

public ArgumentException ();

Public Sub New ()

Uwagi

Ten konstruktor inicjuje Message właściwość nowego wystąpienia do komunikatu dostarczonego przez system, który opisuje błąd, taki jak "Określono nieprawidłowy argument". Ten komunikat uwzględnia bieżącą kulturę systemu.

Poniższa tabela prezentuje początkowe wartości właściwości dla wystąpienia klasy ArgumentException.

Właściwość	Wartość
InnerException	Odwołanie o wartości null (Nothing w Visual Basic).
Message	Zlokalizowany ciąg z komunikatem o błędzie.

ArgumentException(String)

Źródło:

ArgumentException.cs

Inicjuje ArgumentException nowe wystąpienie klasy z określonym komunikatem o błędzie.

public:
 ArgumentException(System::String ^ message);

public ArgumentException (string? message);

new ArgumentException : string -> ArgumentException

Public Sub New (message As String)

Parametry

message

String

Komunikat o błędzie wyjaśniający przyczynę wyjątku.

Uwagi

Ten konstruktor inicjuje Message właściwość nowego wystąpienia do komunikatu dostarczonego przez system, który opisuje błąd, taki jak "Określono nieprawidłowy argument". Ten komunikat uwzględnia bieżącą kulturę systemu.

Poniższa tabela prezentuje początkowe wartości właściwości dla wystąpienia klasy ArgumentException.

Właściwość	Wartość
InnerException	Odwołanie o wartości null (Nothing w Visual Basic).
Message	Ciąg komunikatu o błędzie.

ArgumentException(SerializationInfo, StreamingContext)

Źródło:

ArgumentException.cs

Przestroga

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

Inicjuje nowe wystąpienie klasy ArgumentException z zserializowanymi danymi.

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

[<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)

Parametry

info

SerializationInfo

Obiekt zawierający dane serializowanego obiektu.

context

StreamingContext

Informacje kontekstowe dotyczące źródła lub miejsca docelowego.

Atrybuty

ObsoleteAttribute

Uwagi

Ten konstruktor jest wywoływana podczas deserializacji do odtworzenia obiektu wyjątku przesyłanego za pomocą strumienia. Aby uzyskać więcej informacji, zobacz Serializacja XML i SOAP.

Zobacz też

• Serializacja XML i SOAP

ArgumentException(String, Exception)

Źródło:

ArgumentException.cs

Inicjuje nowe wystąpienie ArgumentException klasy z określonym komunikatem o błędzie i odwołaniem do wyjątku wewnętrznego, który jest przyczyną tego wyjątku.

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)

Parametry

message

String

Komunikat o błędzie wyjaśniający przyczynę wyjątku.

innerException

Exception

Wyjątek będący przyczyną bieżącego wyjątku. innerException Jeśli parametr nie jest odwołaniem o wartości null, bieżący wyjątek jest zgłaszany w catch bloku, który obsługuje wyjątek wewnętrzny.

Uwagi

Ten konstruktor inicjuje Message właściwość nowego wystąpienia przy użyciu wartości parametru message . Zawartość parametru message ma być rozumiana przez ludzi. Obiekt wywołujący tego konstruktora jest wymagany w celu zagwarantowania, że ten ciąg został zlokalizowany w bieżącej kulturze systemu.

Wyjątek zgłaszany bezpośrednio w wyniku poprzedniego wyjątku powinien zawierać odwołanie do poprzedniego wyjątku we właściwości InnerException. Właściwość InnerException zwraca tę samą wartość, która została przekazana do konstruktora, lub wartość null, jeśli właściwość InnerException nie przekazuje do konstruktora wartości wyjątku wewnętrznego.

Poniższa tabela prezentuje początkowe wartości właściwości dla wystąpienia klasy ArgumentException.

Właściwość	Wartość
InnerException	Odwołanie do wewnętrznego wyjątku.
Message	Zlokalizowany ciąg z komunikatem o błędzie.

Zobacz też

• Exception
• Obsługa i zgłaszanie wyjątków

ArgumentException(String, String)

Źródło:

ArgumentException.cs

Inicjuje nowe wystąpienie ArgumentException klasy z określonym komunikatem o błędzie i nazwą parametru, który powoduje ten wyjątek.

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)

Parametry

message

String

Komunikat o błędzie wyjaśniający przyczynę wyjątku.

paramName

String

Nazwa parametru, który spowodował bieżący wyjątek.

Przykłady

W poniższym przykładzie kodu pokazano, jak wywołać ArgumentException konstruktor. Ten przykład kodu jest częścią większego przykładu udostępnionego ArgumentException dla klasy .

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;

Uwagi

Ten konstruktor inicjuje Message właściwość nowego wystąpienia przy użyciu wartości parametru message . Zawartość parametru message ma być rozumiana przez ludzi. Obiekt wywołujący tego konstruktora jest wymagany w celu zagwarantowania, że ten ciąg został zlokalizowany w bieżącej kulturze systemu.

Ten konstruktor inicjuje ParamName właściwość nowego wystąpienia przy użyciu polecenia paramName. Zawartość ma paramName być rozumiana przez ludzi.

Poniższa tabela prezentuje początkowe wartości właściwości dla wystąpienia klasy ArgumentException.

Właściwość	Wartość
Message	Ciąg komunikatu o błędzie.
ParamName	Ciąg nazwy parametru.

ArgumentException(String, String, Exception)

Źródło:

ArgumentException.cs

Inicjuje nowe wystąpienie ArgumentException klasy z określonym komunikatem o błędzie, nazwą parametru i odwołaniem do wewnętrznego wyjątku, który jest przyczyną tego wyjątku.

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)

Parametry

message

String

Komunikat o błędzie wyjaśniający przyczynę wyjątku.

paramName

String

Nazwa parametru, który spowodował bieżący wyjątek.

innerException

Exception

Wyjątek będący przyczyną bieżącego wyjątku. innerException Jeśli parametr nie jest odwołaniem o wartości null, bieżący wyjątek jest zgłaszany w catch bloku, który obsługuje wyjątek wewnętrzny.

Uwagi

Ten konstruktor inicjuje Message właściwość nowego wystąpienia przy użyciu wartości parametru message . Zawartość parametru message ma być rozumiana przez ludzi. Obiekt wywołujący tego konstruktora jest wymagany w celu zagwarantowania, że ten ciąg został zlokalizowany w bieżącej kulturze systemu.

Ten konstruktor inicjuje ParamName właściwość nowego wystąpienia przy użyciu polecenia paramName. Zawartość ma paramName być rozumiana przez ludzi.

Wyjątek zgłaszany bezpośrednio w wyniku poprzedniego wyjątku powinien zawierać odwołanie do poprzedniego wyjątku we właściwości InnerException. Właściwość InnerException zwraca tę samą wartość, która została przekazana do konstruktora, lub wartość null, jeśli właściwość InnerException nie przekazuje do konstruktora wartości wyjątku wewnętrznego.

Poniższa tabela prezentuje początkowe wartości właściwości dla wystąpienia klasy ArgumentException.

Właściwość	Wartość
InnerException	Odwołanie do wewnętrznego wyjątku.
Message	Zlokalizowany ciąg z komunikatem o błędzie.
ParamName	Ciąg nazwy parametru.

Zobacz też

• Exception
• Obsługa i zgłaszanie wyjątków