ArgumentException Costruttori

Definizione

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)

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

Inizializza una nuova istanza della classe ArgumentException.

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

Commenti

Questo costruttore inizializza la proprietà della nuova istanza su un messaggio fornito dal sistema che descrive l'errore, ad esempio "È stato specificato un argomento Message non valido". Il messaggio prende in considerazione le impostazioni di 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.

Si applica a

ArgumentException(String)

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

public:
 ArgumentException(System::String ^ message);
public ArgumentException (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 proprietà della nuova istanza su un messaggio fornito dal sistema che descrive l'errore, ad esempio "È stato specificato un argomento Message non valido". Il messaggio prende in considerazione le impostazioni di 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.

Si applica a

ArgumentException(SerializationInfo, StreamingContext)

Inizializza una nuova istanza della classe ArgumentException con dati serializzati.

protected:
 ArgumentException(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);
protected ArgumentException (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
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.

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

Si applica a

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.

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)

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 parametro message . 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

Si applica a

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.

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)

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

Commenti

Questo costruttore inizializza la Message proprietà della nuova istanza usando il valore del parametro message . 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 di 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.

Si applica a

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.

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)

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 parametro message . 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 di 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

Si applica a