Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Classe ArgumentException

 

Data di pubblicazione: ottobre 2016

L'eccezione generata quando uno degli argomenti forniti a un metodo non è valido.

Spazio dei nomi:   System
Assembly:  mscorlib (in mscorlib.dll)


[SerializableAttribute]
[ComVisibleAttribute(true)]
public class ArgumentException : SystemException, ISerializable

NomeDescrizione
System_CAPS_pubmethodArgumentException()

Inizializza una nuova istanza della classe ArgumentException.

System_CAPS_protmethodArgumentException(SerializationInfo, StreamingContext)

Inizializza una nuova istanza della classe ArgumentException con dati serializzati.

System_CAPS_pubmethodArgumentException(String)

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

System_CAPS_pubmethodArgumentException(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.

System_CAPS_pubmethodArgumentException(String, String)

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

System_CAPS_pubmethodArgumentException(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.

NomeDescrizione
System_CAPS_pubpropertyData

Ottiene una collezione di coppie chiave/valore che forniscono ulteriori informazioni definite dall'utente sull'eccezione. (Ereditato da Exception.)

System_CAPS_pubpropertyHelpLink

Ottiene o imposta un collegamento al file della Guida associato all'eccezione.(Ereditato da Exception.)

System_CAPS_pubpropertyHResult

Ottiene o imposta HRESULT, un valore numerico codificato che viene assegnato ad una specifica eccezione. (Ereditato da Exception.)

System_CAPS_pubpropertyInnerException

Ottiene l'istanza di Exception che ha causato l'eccezione corrente.(Ereditato da Exception.)

System_CAPS_pubpropertyMessage

Ottiene il messaggio di errore e il nome del parametro o, se non è stato impostato alcun nome di parametro, soltanto il messaggio di errore.(Esegue l'override di Exception.Message.)

System_CAPS_pubpropertyParamName

Ottiene il nome del parametro che ha causato questa eccezione.

System_CAPS_pubpropertySource

Ottiene o imposta il nome dell'oggetto o dell'applicazione che ha generato l'errore.(Ereditato da Exception.)

System_CAPS_pubpropertyStackTrace

Ottiene una rappresentazione in forma di stringa dei frame nello stack di chiamate. (Ereditato da Exception.)

System_CAPS_pubpropertyTargetSite

Ottiene il metodo che ha generato l'eccezione corrente. (Ereditato da Exception.)

NomeDescrizione
System_CAPS_pubmethodEquals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object.)

System_CAPS_protmethodFinalize()

Consente a un oggetto di provare a liberare risorse ed eseguire altre operazioni di pulizia prima che l'oggetto stesso venga reclamato dalla procedura di Garbage Collection. (Ereditato da Object.)

System_CAPS_pubmethodGetBaseException()

Quando ne viene eseguito l'override in una classe derivata, restituisce l'Exception che è la causa radice di una o più eccezioni successive.(Ereditato da Exception.)

System_CAPS_pubmethodGetHashCode()

Funge da funzione hash predefinita.(Ereditato da Object.)

System_CAPS_pubmethodGetObjectData(SerializationInfo, StreamingContext)

Imposta l'oggetto SerializationInfo con il nome del parametro e informazioni aggiuntive sull'eccezione.(Esegue l'override di Exception.GetObjectData(SerializationInfo, StreamingContext).)

System_CAPS_pubmethodGetType()

Ottiene il tipo di runtime dell'istanza corrente.(Ereditato da Exception.)

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.(Ereditato da Object.)

System_CAPS_pubmethodToString()

Crea e restituisce una rappresentazione di stringa dell'eccezione corrente.(Ereditato da Exception.)

NomeDescrizione
System_CAPS_proteventSerializeObjectState

Si verifica quando un'eccezione viene serializzata per creare un oggetto di stato eccezione contenente i dati serializzati relativi all'eccezione.(Ereditato da Exception.)

ArgumentExceptionviene generata quando viene richiamato un metodo e almeno uno degli argomenti passati non soddisfa la specifica del parametro del metodo chiamato. Il ParamName proprietà identifica l'argomento non valido.

In genere, un ArgumentException viene generata da un'altra libreria di classi o common language runtime e indica l'errore developer. Se si genera un ArgumentException dal codice, è consigliabile verificare che l'eccezione Message proprietà include un messaggio di errore significativo che descrive l'argomento non valido e l'intervallo di valori per l'argomento previsto.

Il database primario le classi derivate di ArgumentException sono ArgumentNullException e ArgumentOutOfRangeException. Queste classi derivate da utilizzare al posto di ArgumentException, tranne nei casi in cui nessuna delle classi derivate sia accettabile. Eccezioni, ad esempio, devono essere generate da:

  • ArgumentNullExceptionogni volta che null viene passato a un metodo che non lo accetta come argomento valido.

  • ArgumentOutOfRangeExceptionQuando il valore di un argomento è compreso nell'intervallo dei valori accettabili. ad esempio, quando il valore "46" viene passato come argomento mese durante la creazione di un DateTime.

Se la chiamata al metodo non dispone di argomenti o se l'errore riguarda gli argomenti stessi, quindi InvalidOperationException deve essere utilizzato.

ArgumentExceptionutilizza HRESULT COR_E_ARGUMENT, con valore 0x80070057.

Per un elenco di valori di proprietà iniziali per un'istanza di ArgumentException, vedere il ArgumentException costruttori.

Nell'esempio riportato di seguito viene illustrato come generare e intercettare un ArgumentException. Usa il ArgumentException.GetType(). Nome proprietà per visualizzare il nome dell'oggetto eccezione, nonché viene utilizzato il Message proprietà per visualizzare il testo del messaggio dell'eccezione.

using System;

public class Example 
{
    static void Main() 
    {
        // Define some integers for a division operation.
        int[] values = { 10, 7 };
        foreach (var value in values) {
            try {
               Console.WriteLine("{0} divided by 2 is {1}", value, DivideByTwo(value));
            }
            catch (ArgumentException e) {
               Console.WriteLine("{0}: {1}", e.GetType().Name, e.Message);
            }
            Console.WriteLine();
        }
    }

    static int DivideByTwo(int num) 
    {
        // If num is an odd number, throw an ArgumentException.
        if ((num & 1) == 1)
            throw new ArgumentException(String.Format("{0} is not an even number", num), 
                                      "num");

        // num is even, return half of its value.
        return num / 2;
    }
}
// This example displays the following output:
//     10 divided by 2 is 5
//     
//     ArgumentException: 7 is not an even number
//     Parameter name: num

Universal Windows Platform
Disponibile da 8
.NET Framework
Disponibile da 1.1
Libreria di classi portabile
Supportato in: piattaforme .NET portabili
Silverlight
Disponibile da 2.0
Windows Phone Silverlight
Disponibile da 7.0
Windows Phone
Disponibile da 8.1

I membri statici pubblici ( Condiviso in Visual Basic) di questo tipo è thread safe. Non tutti i membri di istanza sono garantiti come thread safe.

Torna all'inizio
Mostra: