ArgumentException Costruttori

Definizione

Inizializza una nuova istanza della classe ArgumentException.Initializes a new instance of the ArgumentException class.

Overload

ArgumentException()

Inizializza una nuova istanza della classe ArgumentException.Initializes a new instance of the ArgumentException class.

ArgumentException(String)

Inizializza una nuova istanza della classe ArgumentException con un messaggio di errore specificato.Initializes a new instance of the ArgumentException class with a specified error message.

ArgumentException(SerializationInfo, StreamingContext)

Inizializza una nuova istanza della classe ArgumentException con dati serializzati.Initializes a new instance of the ArgumentException class with serialized data.

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.Initializes a new instance of the ArgumentException class with a specified error message and a reference to the inner exception that is the cause of this exception.

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.Initializes a new instance of the ArgumentException class with a specified error message and the name of the parameter that causes this exception.

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.Initializes a new instance of the ArgumentException class with a specified error message, the parameter name, and a reference to the inner exception that is the cause of this exception.

ArgumentException()

Inizializza una nuova istanza della classe ArgumentException.Initializes a new instance of the ArgumentException class.

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

Commenti

Questo costruttore inizializza la Message proprietà della nuova istanza su un messaggio fornito dal sistema in cui viene descritto l'errore, ad esempio "è stato specificato un argomento non valido".This constructor initializes the Message property of the new instance to a system-supplied message that describes the error, such as "An invalid argument was specified." Questo messaggio prende in considerazione le impostazioni cultura correnti del sistema.This message takes into account the current system culture.

Nella tabella seguente vengono illustrati i valori di proprietà iniziali per un'istanza di ArgumentException.The following table shows the initial property values for an instance of ArgumentException.

ProprietàProperty ValoreValue
InnerException Riferimento null (Nothing in Visual Basic).A null reference (Nothing in Visual Basic).
Message Stringa del messaggio di errore localizzato.The localized error message string.

ArgumentException(String)

Inizializza una nuova istanza della classe ArgumentException con un messaggio di errore specificato.Initializes a new instance of the ArgumentException class with a specified error message.

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.The error message that explains the reason for the exception.

Commenti

Questo costruttore inizializza la Message proprietà della nuova istanza su un messaggio fornito dal sistema in cui viene descritto l'errore, ad esempio "è stato specificato un argomento non valido".This constructor initializes the Message property of the new instance to a system-supplied message that describes the error, such as "An invalid argument was specified." Questo messaggio prende in considerazione le impostazioni cultura correnti del sistema.This message takes into account the current system culture.

Nella tabella seguente vengono illustrati i valori di proprietà iniziali per un'istanza di ArgumentException.The following table shows the initial property values for an instance of ArgumentException.

ProprietàProperty ValoreValue
InnerException Riferimento null (Nothing in Visual Basic).A null reference (Nothing in Visual Basic).
Message Stringa del messaggio di errore.The error message string.

ArgumentException(SerializationInfo, StreamingContext)

Inizializza una nuova istanza della classe ArgumentException con dati serializzati.Initializes a new instance of the ArgumentException class with serialized data.

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.The object that holds the serialized object data.

context
StreamingContext

Informazioni contestuali sull'origine o sulla destinazione.The contextual information about the source or destination.

Commenti

Questo costruttore viene chiamato durante la deserializzazione per ricostituire l'oggetto eccezione trasmesso su un flusso.This constructor is called during deserialization to reconstitute the exception object transmitted over a stream. Per altre informazioni, vedere serializzazione SOAP e XML.For more information, see XML and SOAP Serialization.

Vedi anche

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.Initializes a new instance of the ArgumentException class with a specified error message and a reference to the inner exception that is the cause of this exception.

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.The error message that explains the reason for the exception.

innerException
Exception

Eccezione che ha determinato l'eccezione corrente.The exception that is the cause of the current exception. Se il parametro innerException non è un riferimento Null, l'eccezione corrente verrà generata in un blocco catch che gestisce l'eccezione interna.If the innerException parameter is not a null reference, the current exception is raised in a catch block that handles the inner exception.

Commenti

Questo costruttore inizializza la Message proprietà della nuova istanza di usando il valore message del parametro.This constructor initializes the Message property of the new instance using the value of the message parameter. Il contenuto del parametro message deve essere facilmente comprensibile.The content of the message parameter is intended to be understood by humans. Il chiamante del costruttore deve garantire che la stringa sia stata localizzata in base alle impostazioni cultura correnti del sistema.The caller of this constructor is required to ensure that this string has been localized for the current system culture.

Un'eccezione generata come risultato diretto di un'eccezione precedente deve includere un riferimento all'eccezione precedente nella proprietà InnerException.An exception that is thrown as a direct result of a previous exception should include a reference to the previous exception in the InnerException property. La proprietà InnerException restituisce lo stesso valore passato al costruttore oppure null nel caso in cui la proprietà InnerException non fornisca il valore di eccezione interna al costruttore.The InnerException property returns the same value that is passed into the constructor, or null if the InnerException property does not supply the inner exception value to the constructor.

Nella tabella seguente vengono illustrati i valori di proprietà iniziali per un'istanza di ArgumentException.The following table shows the initial property values for an instance of ArgumentException.

ProprietàProperty ValoreValue
InnerException Riferimento all'eccezione interna.The inner exception reference.
Message Stringa del messaggio di errore localizzato.The localized error message string.

Vedi anche

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.Initializes a new instance of the ArgumentException class with a specified error message and the name of the parameter that causes this exception.

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.The error message that explains the reason for the exception.

paramName
String

Nome del parametro che è la causa dell'eccezione corrente.The name of the parameter that caused the current exception.

Esempi

Nell'esempio di codice riportato di seguito viene illustrato ArgumentException come chiamare il costruttore.The following code example demonstrates how to call the ArgumentException constructor. Questo esempio di codice fa parte di un esempio più ampio fornito ArgumentException per la classe.This code example is part of a larger example provided for the ArgumentException class.

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 di usando il valore message del parametro.This constructor initializes the Message property of the new instance using the value of the message parameter. Il contenuto del parametro message deve essere facilmente comprensibile.The content of the message parameter is intended to be understood by humans. Il chiamante del costruttore deve garantire che la stringa sia stata localizzata in base alle impostazioni cultura correnti del sistema.The caller of this constructor is required to ensure that this string has been localized for the current system culture.

Questo costruttore inizializza la ParamName proprietà della nuova istanza usando. paramNameThis constructor initializes the ParamName property of the new instance using paramName. Il contenuto di paramName deve essere facilmente comprensibile.The content of paramName is intended to be understood by humans.

Nella tabella seguente vengono illustrati i valori di proprietà iniziali per un'istanza di ArgumentException.The following table shows the initial property values for an instance of ArgumentException.

ProprietàProperty ValueValue
Message Stringa del messaggio di errore.The error message string.
ParamName Stringa del nome del parametro.The parameter name string.

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.Initializes a new instance of the ArgumentException class with a specified error message, the parameter name, and a reference to the inner exception that is the cause of this exception.

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.The error message that explains the reason for the exception.

paramName
String

Nome del parametro che è la causa dell'eccezione corrente.The name of the parameter that caused the current exception.

innerException
Exception

Eccezione che ha determinato l'eccezione corrente.The exception that is the cause of the current exception. Se il parametro innerException non è un riferimento Null, l'eccezione corrente verrà generata in un blocco catch che gestisce l'eccezione interna.If the innerException parameter is not a null reference, the current exception is raised in a catch block that handles the inner exception.

Commenti

Questo costruttore inizializza la Message proprietà della nuova istanza di usando il valore message del parametro.This constructor initializes the Message property of the new instance using the value of the message parameter. Il contenuto del parametro message deve essere facilmente comprensibile.The content of the message parameter is intended to be understood by humans. Il chiamante del costruttore deve garantire che la stringa sia stata localizzata in base alle impostazioni cultura correnti del sistema.The caller of this constructor is required to ensure that this string has been localized for the current system culture.

Questo costruttore inizializza la ParamName proprietà della nuova istanza usando. paramNameThis constructor initializes the ParamName property of the new instance using paramName. Il contenuto di paramName deve essere facilmente comprensibile.The content of paramName is intended to be understood by humans.

Un'eccezione generata come risultato diretto di un'eccezione precedente deve includere un riferimento all'eccezione precedente nella proprietà InnerException.An exception that is thrown as a direct result of a previous exception should include a reference to the previous exception in the InnerException property. La proprietà InnerException restituisce lo stesso valore passato al costruttore oppure null nel caso in cui la proprietà InnerException non fornisca il valore di eccezione interna al costruttore.The InnerException property returns the same value that is passed into the constructor, or null if the InnerException property does not supply the inner exception value to the constructor.

Nella tabella seguente vengono illustrati i valori di proprietà iniziali per un'istanza di ArgumentException.The following table shows the initial property values for an instance of ArgumentException.

ProprietàProperty ValoreValue
InnerException Riferimento all'eccezione interna.The inner exception reference.
Message Stringa del messaggio di errore localizzato.The localized error message string.
ParamName Stringa del nome del parametro.The parameter name string.

Vedi anche

Si applica a