ArgumentException Costruttori
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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()
- Origine:
- ArgumentException.cs
- Origine:
- ArgumentException.cs
- 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 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)
- Origine:
- ArgumentException.cs
- Origine:
- ArgumentException.cs
- Origine:
- ArgumentException.cs
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 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. |
Si applica a
ArgumentException(SerializationInfo, StreamingContext)
- Origine:
- ArgumentException.cs
- Origine:
- ArgumentException.cs
- 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 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);
[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)
Parametri
- info
- SerializationInfo
Oggetto che contiene i dati oggetto serializzati.
- context
- StreamingContext
Informazioni contestuali sull'origine o sulla destinazione.
- Attributi
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)
- Origine:
- ArgumentException.cs
- Origine:
- ArgumentException.cs
- Origine:
- 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);
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
Si applica a
ArgumentException(String, String)
- Origine:
- ArgumentException.cs
- Origine:
- ArgumentException.cs
- Origine:
- 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);
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. |
Si applica a
ArgumentException(String, String, Exception)
- Origine:
- ArgumentException.cs
- Origine:
- ArgumentException.cs
- Origine:
- 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);
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. |