Udostępnij za pośrednictwem


ArgumentException Konstruktory

Definicja

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
Źródło:
ArgumentException.cs
Ź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.

Dotyczy

ArgumentException(String)

Źródło:
ArgumentException.cs
Źródło:
ArgumentException.cs
Ź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);
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.

Dotyczy

ArgumentException(SerializationInfo, StreamingContext)

Źródło:
ArgumentException.cs
Źródło:
ArgumentException.cs
Ź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);
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)

Parametry

info
SerializationInfo

Obiekt zawierający dane serializowanego obiektu.

context
StreamingContext

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

Atrybuty

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ż

Dotyczy

ArgumentException(String, Exception)

Źródło:
ArgumentException.cs
Źródło:
ArgumentException.cs
Ź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);
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ż

Dotyczy

ArgumentException(String, String)

Źródło:
ArgumentException.cs
Źródło:
ArgumentException.cs
Ź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);
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.

Dotyczy

ArgumentException(String, String, Exception)

Źródło:
ArgumentException.cs
Źródło:
ArgumentException.cs
Ź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);
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ż

Dotyczy