Funzione ErrorToString

Articolo
09/12/2008

Aggiornamento: novembre 2007

Restituisce il messaggio di errore corrispondente a un determinato numero di errore.

Public Shared Function ErrorToString(ByVal ErrorNumber As Integer) As String

Parametri

ErrorNumber
Facoltativo. Qualsiasi numero di errore valido.

Eccezioni

Tipo di eccezione	Numero di errore	Condizione
ArgumentException	5	ErrorNumber non è compreso nell'intervallo consentito.

Se si esegue l'aggiornamento delle applicazioni Visual Basic 6.0 che utilizzano la gestione degli errori non strutturata, vedere la colonna "Numero di errore". È possibile confrontare il numero di errore con la Proprietà Number (oggetto Err). Se possibile, tuttavia, si consiglia di sostituire il controllo dell'errore con la procedura illustrata nella sezione Cenni preliminari sulla gestione strutturata delle eccezioni per Visual Basic.

Note

La funzione ErrorToString esamina le impostazioni delle proprietà dell'oggetto Err per identificare l'errore di runtime più recente. Il valore restituito dalla funzione ErrorToString corrisponde alla proprietà Description dell'oggetto Err. Se ErrorNumber corrisponde a un numero di errore valido ma non è definito, ErrorToString restituisce la stringa "Application-defined or object-defined error." Se ErrorNumber non è valido, si verifica un errore. Se ErrorNumber viene omesso, verrà restituito il messaggio corrispondente all'errore di runtime più recente. Se non si è verificato alcun errore di runtime o se ErrorNumber è uguale a 0, ErrorToString restituisce una stringa di lunghezza zero ("").

In Visual Basic versione 6.0 e precedenti questa funzionalità era fornita dalla funzione Error.

Esempio

Nel codice riportato di seguito la funzione ErrorToString viene utilizzata per visualizzare messaggi di errore corrispondenti ai numeri di errore specificati.

Dim ErrorNumber As Integer
For ErrorNumber = 61 To 64   ' Loop through values 61 - 64.
   MsgBox(ErrorToString(ErrorNumber))   ' Display error names in message box.
Next ErrorNumber