ArgumentException Konstruktory

Definice

Obor názvů:

System

Sestavení:

netstandard.dll, System.Runtime.dll

Inicializuje novou instanci ArgumentException třídy.

Přetížení

Name	Description
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 ArgumentException třídy 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

Inicializuje novou instanci ArgumentException třídy.

public:
 ArgumentException();

public ArgumentException();

Public Sub New ()

Poznámky

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

V následující tabulce jsou uvedeny počáteční hodnoty vlastností instance ArgumentException.

Vlastnictví	Hodnota
InnerException	Odkaz null (Nothing v jazyce Visual Basic).
Message	Lokalizovaný řetězec chybové zprávy.

ArgumentException(String)

Zdroj:

ArgumentException.cs

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

public:
 ArgumentException(System::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 do zprávy zadané systémem, která popisuje chybu, například "Byl zadán neplatný argument". Tato zpráva bere v úvahu aktuální systémovou jazykovou verzi.

V následující tabulce jsou uvedeny počáteční hodnoty vlastností instance ArgumentException.

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

ArgumentException(SerializationInfo, StreamingContext)

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 ArgumentException třídy serializovanými daty.

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

Objekt, který obsahuje serializovaná data objektu.

context

StreamingContext

Kontextové informace o zdroji nebo cíli.

Atributy

ObsoleteAttribute

Poznámky

Tento konstruktor je volána během deserializace k rekonstituci objekt výjimky přenášený přes datový proud. Další informace naleznete v tématu XML a SOAP Serializace.

Viz také

• Serializace XML a SOAP

ArgumentException(String, Exception)

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

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ý lidmi. Volající tohoto konstruktoru je nutný k zajištění toho, aby byl tento řetězec lokalizován pro aktuální systémovou jazykovou verzi.

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

V následující tabulce jsou uvedeny počáteční hodnoty vlastností instance ArgumentException.

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

Viz také

• Exception
• Zpracování a vyvolání výjimek

ArgumentException(String, String)

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

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 konstruktoru. Tento příklad kódu je součástí většího příkladu uvedeného pro třídu ArgumentException.

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ý lidmi. Volající tohoto konstruktoru je nutný k zajištění toho, aby byl tento řetězec lokalizován pro aktuální systémovou jazykovou verzi.

Tento konstruktor inicializuje ParamName vlastnost nové instance pomocí paramName. paramName Obsah je určen k pochopení lidmi.

V následující tabulce jsou uvedeny počáteční hodnoty vlastností instance ArgumentException.

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

ArgumentException(String, String, Exception)

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

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ý lidmi. Volající tohoto konstruktoru je nutný k zajištění toho, aby byl tento řetězec lokalizován pro aktuální systémovou jazykovou verzi.

Tento konstruktor inicializuje ParamName vlastnost nové instance pomocí paramName. paramName Obsah je určen k pochopení lidmi.

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

V následující tabulce jsou uvedeny počáteční hodnoty vlastností instance ArgumentException.

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

Viz také

• Exception
• Zpracování a vyvolání výjimek