ArgumentException Costruttori

Definizione

Spazio dei nomi:

System

Assembly:

System.Runtime.dll

Inizializza una nuova istanza della classe ArgumentException.

Overload

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

ArgumentException()

Source:

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 di proprietà iniziali per un'istanza di ArgumentException.

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

ArgumentException(String)

Source:

ArgumentException.cs

Inizializza una nuova istanza della classe ArgumentException 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 in cui viene indicato 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 di proprietà iniziali per un'istanza di ArgumentException.

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

ArgumentException(SerializationInfo, StreamingContext)

Source:

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 classe ArgumentException 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 oggetto serializzati.

context

StreamingContext

Informazioni contestuali sull'origine o sulla destinazione.

Attributi

ObsoleteAttribute

Commenti

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

Vedi anche

• Serializzazione SOAP e XML

ArgumentException(String, Exception)

Source:

ArgumentException.cs

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

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 in cui viene indicato il motivo dell'eccezione.

innerException

Exception

Eccezione che ha determinato l'eccezione corrente. Se il parametro innerException non è un riferimento Null, l'eccezione corrente verrà generata in un blocco catch che gestisce l'eccezione interna.

Commenti

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

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

Nella tabella seguente vengono illustrati i valori di proprietà iniziali 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)

Source:

ArgumentException.cs

Inizializza una nuova istanza della classe ArgumentException con un messaggio di errore specificato e il nome del parametro che genera 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 in cui viene indicato il motivo dell'eccezione.

paramName

String

Nome del parametro che è la causa dell'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 .

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;

Commenti

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

Questo costruttore inizializza la ParamName proprietà della nuova istanza utilizzando paramName. Il contenuto di paramName deve essere facilmente comprensibile.

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

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

ArgumentException(String, String, Exception)

Source:

ArgumentException.cs

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

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 in cui viene indicato il motivo dell'eccezione.

paramName

String

Nome del parametro che è la causa dell'eccezione corrente.

innerException

Exception

Eccezione che ha determinato l'eccezione corrente. Se il parametro innerException non è un riferimento Null, l'eccezione corrente verrà generata in un blocco catch che gestisce l'eccezione interna.

Commenti

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

Questo costruttore inizializza la ParamName proprietà della nuova istanza utilizzando paramName. Il contenuto di paramName deve essere facilmente comprensibile.

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

Nella tabella seguente vengono illustrati i valori di proprietà iniziali 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