ArgumentException Konstruktory
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Inicializuje novou instanci ArgumentException třídy.
Přetížení
ArgumentException() |
Inicializuje novou instanci ArgumentException třídy. |
ArgumentException(String) |
Inicializuje novou instanci třídy ArgumentException se zadanou chybovou zprávou. |
ArgumentException(SerializationInfo, StreamingContext) |
Zastaralé.
Inicializuje novou instanci třídy ArgumentException 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 třídy ArgumentException 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 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.
Následující tabulka uvádí počáteční hodnoty vlastností pro instanci ArgumentException.
Vlastnost | Hodnota |
---|---|
InnerException | Nulový odkaz (Nothing v jazyce Visual Basic). |
Message | Lokalizovaný řetězec chybové zprávy. |
Platí pro
ArgumentException(String)
- Zdroj:
- ArgumentException.cs
- Zdroj:
- ArgumentException.cs
- Zdroj:
- ArgumentException.cs
Inicializuje novou instanci třídy ArgumentException 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 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.
Následující tabulka uvádí počáteční hodnoty vlastností pro instanci ArgumentException.
Vlastnost | Hodnota |
---|---|
InnerException | Nulový odkaz (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 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ý obsahuje serializovaná data objektu.
- context
- StreamingContext
Kontextové informace o zdroji nebo cíli.
- Atributy
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é
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. Pokud parametr innerException
není odkazem null, je aktuální výjimka vyvolána v bloku catch
, který zpracovává vnitřní výjimku.
Poznámky
Tento konstruktor inicializuje Message vlastnost nové instance pomocí hodnoty message
parametru. Obsah parametru message
je určen pro pochopení lidí. 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 vyvolaná jako přímý výsledek předchozí výjimky by měla obsahovat odkaz na předchozí výjimku ve vlastnosti InnerException. Vlastnost InnerException vrátí stejnou hodnotu, která je předána do konstruktoru, nebo null
, pokud vlastnost InnerException nezadává vnitřní hodnotu výjimky konstruktoru.
Následující tabulka uvádí počáteční hodnoty vlastností pro instanci ArgumentException.
Vlastnost | Hodnota |
---|---|
InnerException | Odkaz na vnitřní výjimku. |
Message | Lokalizovaný řetězec 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 konstruktoru. Tento příklad kódu je součástí většího příkladu poskytnutého pro třídu 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;
Poznámky
Tento konstruktor inicializuje Message vlastnost nové instance pomocí hodnoty message
parametru. Obsah parametru message
je určen pro pochopení lidí. 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
. Obsah paramName
je určen k pochopení lidí.
Následující tabulka uvádí počáteční hodnoty vlastností pro instanci 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 třídy ArgumentException 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. Pokud parametr innerException
není odkazem null, je aktuální výjimka vyvolána v bloku catch
, který zpracovává vnitřní výjimku.
Poznámky
Tento konstruktor inicializuje Message vlastnost nové instance pomocí hodnoty message
parametru. Obsah parametru message
je určen pro pochopení lidí. 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
. Obsah paramName
je určen k pochopení lidí.
Výjimka vyvolaná jako přímý výsledek předchozí výjimky by měla obsahovat odkaz na předchozí výjimku ve vlastnosti InnerException. Vlastnost InnerException vrátí stejnou hodnotu, která je předána do konstruktoru, nebo null
, pokud vlastnost InnerException nezadává vnitřní hodnotu výjimky konstruktoru.
Následující tabulka uvádí počáteční hodnoty vlastností pro instanci ArgumentException.
Vlastnost | Hodnota |
---|---|
InnerException | Odkaz na vnitřní výjimku. |
Message | Lokalizovaný řetězec chybové zprávy. |
ParamName | Řetězec názvu parametru. |