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 nowe wystąpienie klasy ArgumentException z określonym komunikatem o błędzie.
ArgumentException(SerializationInfo, StreamingContext)	Przestarzałe. Inicjuje nowe wystąpienie klasy ArgumentException z serializowanymi danymi.
ArgumentException(String, Exception)	Inicjuje nowe wystąpienie klasy ArgumentException 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 klasy ArgumentException z określonym komunikatem o błędzie i nazwą parametru, który powoduje ten wyjątek.
ArgumentException(String, String, Exception)	Inicjuje nowe wystąpienie klasy ArgumentException z określonym komunikatem o błędzie, nazwą parametru i odwołaniem do wyjątku wewnętrznego, 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 właściwość Message 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.

W poniższej tabeli przedstawiono początkowe wartości właściwości dla wystąpienia ArgumentException.

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

ArgumentException(String)

Źródło:

ArgumentException.cs

Inicjuje nowe wystąpienie klasy ArgumentException 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 właściwość Message 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.

W poniższej tabeli przedstawiono początkowe wartości właściwości dla wystąpienia ArgumentException.

Własność	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 serializowanymi 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, który przechowuje serializowane dane obiektu.

context

StreamingContext

Kontekstowe informacje o źródle lub miejscu docelowym.

Atrybuty

ObsoleteAttribute

Uwagi

Ten konstruktor jest wywoływany podczas deserializacji w celu ponownego utworzenia obiektu wyjątku przesyłanego przez strumień. Aby uzyskać więcej informacji, zobacz XML i SOAP Serialization.

Zobacz też

• XML i SOAP Serializacji

ArgumentException(String, Exception)

Źródło:

ArgumentException.cs

Inicjuje nowe wystąpienie klasy ArgumentException 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, który jest przyczyną bieżącego wyjątku. Jeśli parametr innerException nie jest odwołaniem o wartości null, bieżący wyjątek jest zgłaszany w bloku catch, który obsługuje wyjątek wewnętrzny.

Uwagi

Ten konstruktor inicjuje właściwość Message 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, aby upewnić się, że ten ciąg został zlokalizowany dla bieżącej kultury 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 jest przekazywana do konstruktora, lub null, jeśli właściwość InnerException nie dostarcza wartości wyjątku wewnętrznego do konstruktora.

W poniższej tabeli przedstawiono początkowe wartości właściwości dla wystąpienia ArgumentException.

Własność	Wartość
InnerException	Odwołanie do wyjątku wewnętrznego.
Message	Zlokalizowany ciąg komunikatu 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 klasy ArgumentException 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ć konstruktor ArgumentException. Ten przykład kodu jest częścią większego przykładu udostępnionego dla klasy 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;

Uwagi

Ten konstruktor inicjuje właściwość Message 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, aby upewnić się, że ten ciąg został zlokalizowany dla bieżącej kultury systemu.

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

W poniższej tabeli przedstawiono początkowe wartości właściwości dla wystąpienia ArgumentException.

Własność	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 klasy ArgumentException z określonym komunikatem o błędzie, nazwą parametru i odwołaniem do wyjątku wewnętrznego, 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, który jest przyczyną bieżącego wyjątku. Jeśli parametr innerException nie jest odwołaniem o wartości null, bieżący wyjątek jest zgłaszany w bloku catch, który obsługuje wyjątek wewnętrzny.

Uwagi

Ten konstruktor inicjuje właściwość Message 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, aby upewnić się, że ten ciąg został zlokalizowany dla bieżącej kultury systemu.

Ten konstruktor inicjuje właściwość ParamName nowego wystąpienia przy użyciu paramName. Zawartość paramName ma 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 jest przekazywana do konstruktora, lub null, jeśli właściwość InnerException nie dostarcza wartości wyjątku wewnętrznego do konstruktora.

W poniższej tabeli przedstawiono początkowe wartości właściwości dla wystąpienia ArgumentException.

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

Zobacz też

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