ArgumentOutOfRangeException Costruttori

Definizione

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

Overload

ArgumentOutOfRangeException()

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

ArgumentOutOfRangeException(String)

Inizializza una nuova istanza della classe ArgumentOutOfRangeException con il nome del parametro che causa l'eccezione.Initializes a new instance of the ArgumentOutOfRangeException class with the name of the parameter that causes this exception.

ArgumentOutOfRangeException(SerializationInfo, StreamingContext)

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

ArgumentOutOfRangeException(String, Exception)

Inizializza una nuova istanza della classe ArgumentOutOfRangeException con un messaggio di errore e l'eccezione che ha causato l'eccezione corrente.Initializes a new instance of the ArgumentOutOfRangeException class with a specified error message and the exception that is the cause of this exception.

ArgumentOutOfRangeException(String, String)

Inizializza una nuova istanza della classe ArgumentOutOfRangeException con il nome del parametro che causa l'eccezione e un messaggio di errore specificato.Initializes a new instance of the ArgumentOutOfRangeException class with the name of the parameter that causes this exception and a specified error message.

ArgumentOutOfRangeException(String, Object, String)

Inizializza una nuova istanza della classe ArgumentOutOfRangeException con il nome del parametro, il valore dell'argomento e un messaggio di errore specificato.Initializes a new instance of the ArgumentOutOfRangeException class with the parameter name, the value of the argument, and a specified error message.

ArgumentOutOfRangeException()

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

public:
 ArgumentOutOfRangeException();
public ArgumentOutOfRangeException ();
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 "numero non negativo obbligatorio".This constructor initializes the Message property of the new instance to a system-supplied message that describes the error, such as "Nonnegative number required." Il messaggio prende in considerazione le impostazioni di 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 ArgumentOutOfRangeException.The following table shows the initial property values for an instance of ArgumentOutOfRangeException.

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.

ArgumentOutOfRangeException(String)

Inizializza una nuova istanza della classe ArgumentOutOfRangeException con il nome del parametro che causa l'eccezione.Initializes a new instance of the ArgumentOutOfRangeException class with the name of the parameter that causes this exception.

public:
 ArgumentOutOfRangeException(System::String ^ paramName);
public ArgumentOutOfRangeException (string paramName);
new ArgumentOutOfRangeException : string -> ArgumentOutOfRangeException
Public Sub New (paramName As String)

Parametri

paramName
String

Nome del parametro che ha causato l'eccezione.The name of the parameter that causes this 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 "numero non negativo obbligatorio".This constructor initializes the Message property of the new instance to a system-supplied message that describes the error, such as "Nonnegative number required." Il messaggio prende in considerazione le impostazioni di cultura correnti del sistema.This message takes into account the current system culture.

Questo costruttore inizializza la proprietà ParamName della nuova istanza utilizzando il parametro paramName.This constructor initializes the ParamName property of the new instance using the paramName parameter. 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 ArgumentOutOfRangeException.The following table shows the initial property values for an instance of ArgumentOutOfRangeException.

ProprietàProperty valoreValue
InnerException Riferimento null (Nothing in Visual Basic).A null reference (Nothing in Visual Basic).
Message Stringa vuota ("").The empty string ("").
ParamName Stringa del nome del parametro.The parameter name string.

ArgumentOutOfRangeException(SerializationInfo, StreamingContext)

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

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

Oggetto che descrive l'origine o la destinazione dei dati serializzati.An object that describes the source or destination of the serialized data.

Commenti

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

Vedi anche

ArgumentOutOfRangeException(String, Exception)

Inizializza una nuova istanza della classe ArgumentOutOfRangeException con un messaggio di errore e l'eccezione che ha causato l'eccezione corrente.Initializes a new instance of the ArgumentOutOfRangeException class with a specified error message and the exception that is the cause of this exception.

public:
 ArgumentOutOfRangeException(System::String ^ message, Exception ^ innerException);
public ArgumentOutOfRangeException (string message, Exception innerException);
new ArgumentOutOfRangeException : string * Exception -> ArgumentOutOfRangeException
Public Sub New (message As String, innerException As Exception)

Parametri

message
String

Messaggio di errore nel quale viene indicata la causa dell'eccezioneThe error message that explains the reason for this exception.

innerException
Exception

Eccezione causa dell'eccezione corrente o riferimento Null (Nothing in Visual Basic) se non viene specificata alcuna eccezione interna.The exception that is the cause of the current exception, or a null reference (Nothing in Visual Basic) if no inner exception is specified.

ArgumentOutOfRangeException(String, String)

Inizializza una nuova istanza della classe ArgumentOutOfRangeException con il nome del parametro che causa l'eccezione e un messaggio di errore specificato.Initializes a new instance of the ArgumentOutOfRangeException class with the name of the parameter that causes this exception and a specified error message.

public:
 ArgumentOutOfRangeException(System::String ^ paramName, System::String ^ message);
public ArgumentOutOfRangeException (string paramName, string message);
new ArgumentOutOfRangeException : string * string -> ArgumentOutOfRangeException
Public Sub New (paramName As String, message As String)

Parametri

paramName
String

Nome del parametro che ha causato l'eccezione.The name of the parameter that caused the exception.

message
String

Messaggio in cui viene descritto l'errore.The message that describes the error.

Commenti

Questo costruttore inizializza la Message proprietà della nuova istanza di usando il valore del message 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 di questo costruttore è necessario per assicurarsi che questa stringa sia stata localizzata per le 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 proprietà ParamName della nuova istanza utilizzando il parametro paramName.This constructor initializes the ParamName property of the new instance using the paramName parameter. 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 ArgumentOutOfRangeException.The following table shows the initial property values for an instance of ArgumentOutOfRangeException.

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

ArgumentOutOfRangeException(String, Object, String)

Inizializza una nuova istanza della classe ArgumentOutOfRangeException con il nome del parametro, il valore dell'argomento e un messaggio di errore specificato.Initializes a new instance of the ArgumentOutOfRangeException class with the parameter name, the value of the argument, and a specified error message.

public:
 ArgumentOutOfRangeException(System::String ^ paramName, System::Object ^ actualValue, System::String ^ message);
public ArgumentOutOfRangeException (string paramName, object actualValue, string message);
new ArgumentOutOfRangeException : string * obj * string -> ArgumentOutOfRangeException
Public Sub New (paramName As String, actualValue As Object, message As String)

Parametri

paramName
String

Nome del parametro che ha causato l'eccezione.The name of the parameter that caused the exception.

actualValue
Object

Il valore dell'argomento che causa l'eccezione.The value of the argument that causes this exception.

message
String

Messaggio in cui viene descritto l'errore.The message that describes the error.

Commenti

Questo costruttore inizializza la ParamName proprietà della nuova istanza utilizzando il paramName parametro, la ActualValue proprietà utilizzando il actualValue parametro e la Message proprietà utilizzando il message parametro.This constructor initializes the ParamName property of the new instance using the paramName parameter, the ActualValue property using the actualValue parameter, and the Message property using the message parameter. Il contenuto dei paramName parametri e message è concepito per essere compreso dagli utenti.The content of the paramName and message parameters is intended to be understood by humans. Il chiamante di questo costruttore è necessario per garantire che queste stringhe siano state localizzate per le impostazioni cultura correnti del sistema.The caller of this constructor is required to ensure that these strings have been localized for the current system culture.

Il actualValue parametro non viene utilizzato all'interno della libreria di classi .NET Framework.The actualValue parameter is not used within the .NET Framework class library. Tuttavia, la ActualValue proprietà viene specificata in modo che le applicazioni possano usare il valore dell'argomento disponibile.However, the ActualValue property is provided so that applications can use the available argument value.

Il actualValue parametro contiene un valore non valido passato al metodo e genera questa eccezione.The actualValue parameter contains an invalid value that is passed to the method and causes this exception to be thrown. Questo valore viene archiviato nella ActualValue proprietà e la relativa rappresentazione di stringa viene aggiunta alla stringa di messaggio contenuta nella Message Proprietà.This value is stored in the ActualValue property and its string representation is appended to the message string held in the Message property.

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

ProprietàProperty ValoreValue
ActualValue Valore dell'argomento.The argument value.
InnerException Riferimento null ( Nothing in Visual Basic).The null reference (Nothing in Visual Basic).
Message Stringa del messaggio di errore.The error message string.
ParamName Stringa del nome del parametro.The parameter name string.

Si applica a