ArgumentException Costruttori

Definizione

Spazio dei nomi:

System

Assembly:

netstandard.dll, System.Runtime.dll

Inizializza una nuova istanza della classe ArgumentException.

Overload

Nome	Descrizione
ArgumentException()	Inizializza una nuova istanza della classe ArgumentException.
ArgumentException(String)	Inizializza una nuova istanza della ArgumentException classe con un messaggio di errore specificato.
ArgumentException(SerializationInfo, StreamingContext)	Obsoleti. Inizializza una nuova istanza della ArgumentException classe con dati serializzati.
ArgumentException(String, Exception)	Inizializza una nuova istanza della ArgumentException classe con un messaggio di errore specificato e un riferimento all'eccezione interna che è la causa di questa eccezione.
ArgumentException(String, String)	Inizializza una nuova istanza della ArgumentException classe con un messaggio di errore specificato e il nome del parametro che causa questa eccezione.
ArgumentException(String, String, Exception)	Inizializza una nuova istanza della ArgumentException classe con un messaggio di errore specificato, il nome del parametro e un riferimento all'eccezione interna che è la causa di questa eccezione.

ArgumentException()

Origine:

ArgumentException.cs

Inizializza una nuova istanza della classe ArgumentException.

public:
 ArgumentException();

public ArgumentException();

Public Sub New ()

Commenti

Questo costruttore inizializza la Message proprietà della nuova istanza in un messaggio fornito dal sistema che descrive l'errore, ad esempio "È stato specificato un argomento non valido". Questo messaggio tiene conto delle impostazioni cultura correnti del sistema.

Nella tabella seguente vengono illustrati i valori iniziali delle proprietà per un'istanza di ArgumentException.

Proprietà	Valore
InnerException	Riferimento Null (Nothing in Visual Basic).
Message	Stringa del messaggio di errore localizzato.

ArgumentException(String)

Origine:

ArgumentException.cs

Inizializza una nuova istanza della ArgumentException classe con un messaggio di errore specificato.

public:
 ArgumentException(System::String ^ message);

public ArgumentException(string? message);

new ArgumentException : string -> ArgumentException

Public Sub New (message As String)

Parametri

message

String

Messaggio di errore che spiega il motivo dell'eccezione.

Commenti

Questo costruttore inizializza la Message proprietà della nuova istanza in un messaggio fornito dal sistema che descrive l'errore, ad esempio "È stato specificato un argomento non valido". Questo messaggio tiene conto delle impostazioni cultura correnti del sistema.

Nella tabella seguente vengono illustrati i valori iniziali delle proprietà per un'istanza di ArgumentException.

Proprietà	Valore
InnerException	Riferimento Null (Nothing in Visual Basic).
Message	Stringa del messaggio di errore.

ArgumentException(SerializationInfo, StreamingContext)

Origine:

ArgumentException.cs

Attenzione

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

Inizializza una nuova istanza della ArgumentException classe con dati serializzati.

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)

Parametri

info

SerializationInfo

Oggetto che contiene i dati dell'oggetto serializzato.

context

StreamingContext

Informazioni contestuali sull'origine o sulla destinazione.

Attributi

ObsoleteAttribute

Commenti

Questo costruttore viene chiamato durante la deserializzazione per ricostituire l'oggetto eccezione trasmesso su un flusso. Per altre informazioni, vedere Serializzazione XML e SOAP.

Vedi anche

• Serializzazione XML e SOAP

ArgumentException(String, Exception)

Origine:

ArgumentException.cs

Inizializza una nuova istanza della ArgumentException classe con un messaggio di errore specificato e un riferimento all'eccezione interna che è la causa di questa eccezione.

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)

Parametri

message

String

Messaggio di errore che spiega il motivo dell'eccezione.

innerException

Exception

Eccezione che rappresenta la causa dell'eccezione corrente. Se il innerException parametro non è un riferimento Null, l'eccezione corrente viene generata in un catch blocco che gestisce l'eccezione interna.

Commenti

Questo costruttore inizializza la Message proprietà della nuova istanza utilizzando il valore del message parametro . Il contenuto del message parametro deve essere compreso dagli esseri umani. Il chiamante di questo costruttore è necessario per assicurarsi che questa stringa sia stata localizzata per le impostazioni cultura di sistema correnti.

Un'eccezione generata come risultato diretto di un'eccezione precedente deve includere un riferimento all'eccezione precedente nella InnerException proprietà . La InnerException proprietà restituisce lo stesso valore passato al costruttore oppure null se la InnerException proprietà non fornisce il valore dell'eccezione interna al costruttore.

Nella tabella seguente vengono illustrati i valori iniziali delle proprietà per un'istanza di ArgumentException.

Proprietà	Valore
InnerException	Riferimento all'eccezione interna.
Message	Stringa del messaggio di errore localizzato.

Vedi anche

• Exception
• gestione e generazione di eccezioni

ArgumentException(String, String)

Origine:

ArgumentException.cs

Inizializza una nuova istanza della ArgumentException classe con un messaggio di errore specificato e il nome del parametro che causa questa eccezione.

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)

Parametri

message

String

Messaggio di errore che spiega il motivo dell'eccezione.

paramName

String

Nome del parametro che ha causato l'eccezione corrente.

Esempio

Nell'esempio di codice seguente viene illustrato come chiamare il ArgumentException costruttore. Questo esempio di codice fa parte di un esempio più ampio fornito per la ArgumentException classe .

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;

Commenti

Questo costruttore inizializza la Message proprietà della nuova istanza utilizzando il valore del message parametro . Il contenuto del message parametro deve essere compreso dagli esseri umani. Il chiamante di questo costruttore è necessario per assicurarsi che questa stringa sia stata localizzata per le impostazioni cultura di sistema correnti.

Questo costruttore inizializza la ParamName proprietà della nuova istanza utilizzando paramName. Il contenuto di paramName è destinato a essere compreso dagli esseri umani.

Nella tabella seguente vengono illustrati i valori iniziali delle proprietà per un'istanza di ArgumentException.

Proprietà	Valore
Message	Stringa del messaggio di errore.
ParamName	Stringa del nome del parametro.

ArgumentException(String, String, Exception)

Origine:

ArgumentException.cs

Inizializza una nuova istanza della ArgumentException classe con un messaggio di errore specificato, il nome del parametro e un riferimento all'eccezione interna che è la causa di questa eccezione.

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)

Parametri

message

String

Messaggio di errore che spiega il motivo dell'eccezione.

paramName

String

Nome del parametro che ha causato l'eccezione corrente.

innerException

Exception

Eccezione che rappresenta la causa dell'eccezione corrente. Se il innerException parametro non è un riferimento Null, l'eccezione corrente viene generata in un catch blocco che gestisce l'eccezione interna.

Commenti

Questo costruttore inizializza la Message proprietà della nuova istanza utilizzando il valore del message parametro . Il contenuto del message parametro deve essere compreso dagli esseri umani. Il chiamante di questo costruttore è necessario per assicurarsi che questa stringa sia stata localizzata per le impostazioni cultura di sistema correnti.

Questo costruttore inizializza la ParamName proprietà della nuova istanza utilizzando paramName. Il contenuto di paramName è destinato a essere compreso dagli esseri umani.

Un'eccezione generata come risultato diretto di un'eccezione precedente deve includere un riferimento all'eccezione precedente nella InnerException proprietà . La InnerException proprietà restituisce lo stesso valore passato al costruttore oppure null se la InnerException proprietà non fornisce il valore dell'eccezione interna al costruttore.

Nella tabella seguente vengono illustrati i valori iniziali delle proprietà per un'istanza di ArgumentException.

Proprietà	Valore
InnerException	Riferimento all'eccezione interna.
Message	Stringa del messaggio di errore localizzato.
ParamName	Stringa del nome del parametro.

Vedi anche

• Exception
• gestione e generazione di eccezioni