Sdílet prostřednictvím


ArgumentException Konstruktory

Definice

Inicializuje novou instanci ArgumentException třídy.

Přetížení

ArgumentException()

Inicializuje novou instanci ArgumentException třídy.

ArgumentException(String)

Inicializuje novou instanci ArgumentException třídy se zadanou chybovou zprávou.

ArgumentException(SerializationInfo, StreamingContext)
Zastaralé.

Inicializuje novou instanci třídy ArgumentException se serializovanými daty.

ArgumentException(String, Exception)

Inicializuje novou instanci ArgumentException třídy se zadanou chybovou zprávou a odkazem na vnitřní výjimku, která je příčinou této výjimky.

ArgumentException(String, String)

Inicializuje novou instanci ArgumentException třídy se zadanou chybovou zprávou a názvem parametru, který způsobuje tuto výjimku.

ArgumentException(String, String, Exception)

Inicializuje novou instanci ArgumentException třídy se zadanou chybovou zprávou, názvem parametru a odkazem na vnitřní výjimku, která je příčinou této výjimky.

ArgumentException()

Zdroj:
ArgumentException.cs
Zdroj:
ArgumentException.cs
Zdroj:
ArgumentException.cs

Inicializuje novou instanci ArgumentException třídy.

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

Poznámky

Tento konstruktor inicializuje Message vlastnost nové instance na systémovou zprávu, která popisuje chybu, například "Byl zadán neplatný argument". Tato zpráva bere v úvahu aktuální jazykovou verzi systému.

Následující tabulka ukazuje počáteční hodnoty vlastnosti instance ArgumentException.

Vlastnost Hodnota
InnerException Odkaz s hodnotou null (Nothing v jazyce Visual Basic).
Message Řetězec lokalizované chybové zprávy

Platí pro

ArgumentException(String)

Zdroj:
ArgumentException.cs
Zdroj:
ArgumentException.cs
Zdroj:
ArgumentException.cs

Inicializuje novou instanci ArgumentException třídy se zadanou chybovou zprávou.

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

Chybová zpráva, která vysvětluje důvod výjimky.

Poznámky

Tento konstruktor inicializuje Message vlastnost nové instance na systémovou zprávu, která popisuje chybu, například "Byl zadán neplatný argument". Tato zpráva bere v úvahu aktuální jazykovou verzi systému.

Následující tabulka ukazuje počáteční hodnoty vlastnosti instance ArgumentException.

Vlastnost Hodnota
InnerException Odkaz s hodnotou null (Nothing v jazyce Visual Basic).
Message Řetězec chybové zprávy.

Platí pro

ArgumentException(SerializationInfo, StreamingContext)

Zdroj:
ArgumentException.cs
Zdroj:
ArgumentException.cs
Zdroj:
ArgumentException.cs

Upozornění

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

Inicializuje novou instanci třídy ArgumentException se serializovanými daty.

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

Objekt, který uchovává serializovaná data objektu.

context
StreamingContext

Kontextové informace o zdroji nebo cíli

Atributy

Poznámky

Tento konstruktor je volán během deserializaci k rekonstrukci objektu výjimky přenášeného prostřednictvím toku. Další informace najdete v tématu Serializace XML a SOAP.

Viz také

Platí pro

ArgumentException(String, Exception)

Zdroj:
ArgumentException.cs
Zdroj:
ArgumentException.cs
Zdroj:
ArgumentException.cs

Inicializuje novou instanci ArgumentException třídy se zadanou chybovou zprávou a odkazem na vnitřní výjimku, která je příčinou této výjimky.

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

Chybová zpráva, která vysvětluje důvod výjimky.

innerException
Exception

Výjimka, která je příčinou aktuální výjimky innerException Pokud parametr není odkazem null, aktuální výjimka je vyvolána v catch bloku, který zpracovává vnitřní výjimku.

Poznámky

Tento konstruktor inicializuje Message vlastnost nové instance pomocí hodnoty parametru message . Obsah parametru message má být srozumitelný lidem. Volající, který volá tento konstruktor, musí zajistit, aby byl tento řetězec lokalizován pro aktuální jazykovou verzi systému.

Výjimka, která je vyvolána jako přímý výsledek předchozí výjimky by měla obsahovat odkaz na předchozí výjimku ve vlastnosti InnerException. Vlastnost InnerException vrací stejnou hodnotu, která je předána do konstruktoru, nebo hodnotu null, pokud vlastnost InnerException neposkytne hodnotu vnitřní výjimky konstruktoru.

Následující tabulka ukazuje počáteční hodnoty vlastnosti instance ArgumentException.

Vlastnost Hodnota
InnerException Odkaz na vnitřní výjimku.
Message Řetězec lokalizované chybové zprávy

Viz také

Platí pro

ArgumentException(String, String)

Zdroj:
ArgumentException.cs
Zdroj:
ArgumentException.cs
Zdroj:
ArgumentException.cs

Inicializuje novou instanci ArgumentException třídy se zadanou chybovou zprávou a názvem parametru, který způsobuje tuto výjimku.

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

Chybová zpráva, která vysvětluje důvod výjimky.

paramName
String

Název parametru, který způsobil aktuální výjimku.

Příklady

Následující příklad kódu ukazuje, jak volat ArgumentException konstruktor. Tento příklad kódu je součástí většího příkladu ArgumentException pro třídu.

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;

Poznámky

Tento konstruktor inicializuje Message vlastnost nové instance pomocí hodnoty parametru message . Obsah parametru message má být srozumitelný lidem. Volající, který volá tento konstruktor, musí zajistit, aby byl tento řetězec lokalizován pro aktuální jazykovou verzi systému.

Tento konstruktor inicializuje ParamName vlastnost nové instance pomocí paramName. Obsah paramName je určen k tomu, aby byl lidem srozumitelný.

Následující tabulka ukazuje počáteční hodnoty vlastnosti instance ArgumentException.

Vlastnost Hodnota
Message Řetězec chybové zprávy.
ParamName Řetězec názvu parametru.

Platí pro

ArgumentException(String, String, Exception)

Zdroj:
ArgumentException.cs
Zdroj:
ArgumentException.cs
Zdroj:
ArgumentException.cs

Inicializuje novou instanci ArgumentException třídy se zadanou chybovou zprávou, názvem parametru a odkazem na vnitřní výjimku, která je příčinou této výjimky.

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

Chybová zpráva, která vysvětluje důvod výjimky.

paramName
String

Název parametru, který způsobil aktuální výjimku.

innerException
Exception

Výjimka, která je příčinou aktuální výjimky innerException Pokud parametr není odkazem null, aktuální výjimka je vyvolána v catch bloku, který zpracovává vnitřní výjimku.

Poznámky

Tento konstruktor inicializuje Message vlastnost nové instance pomocí hodnoty parametru message . Obsah parametru message má být srozumitelný lidem. Volající, který volá tento konstruktor, musí zajistit, aby byl tento řetězec lokalizován pro aktuální jazykovou verzi systému.

Tento konstruktor inicializuje ParamName vlastnost nové instance pomocí paramName. Obsah paramName je určen k tomu, aby byl lidem srozumitelný.

Výjimka, která je vyvolána jako přímý výsledek předchozí výjimky by měla obsahovat odkaz na předchozí výjimku ve vlastnosti InnerException. Vlastnost InnerException vrací stejnou hodnotu, která je předána do konstruktoru, nebo hodnotu null, pokud vlastnost InnerException neposkytne hodnotu vnitřní výjimky konstruktoru.

Následující tabulka ukazuje počáteční hodnoty vlastnosti instance ArgumentException.

Vlastnost Hodnota
InnerException Odkaz na vnitřní výjimku.
Message Řetězec lokalizované chybové zprávy
ParamName Řetězec názvu parametru.

Viz také

Platí pro