Oggetto Error

  • Articolo

Contiene informazioni dettagliate sugli errori di accesso ai dati relativi a una singola operazione che interessa il provider.

Osservazioni

Qualsiasi operazione che interessa oggetti ADO può generare uno o più errori del provider. Quando si verifica ogni errore, uno o più oggetti Error vengono inseriti nella raccolta Errors dell'oggetto Connection. Quando un'altra operazione ADO genera un errore, la raccolta Errors viene cancellata e il nuovo set di oggetti Error viene inserito nella raccolta Errors.

Nota

Ogni oggetto Error rappresenta un errore del provider specifico, non un errore ADO. Gli errori ADO vengono esposti al meccanismo di gestione delle eccezioni in fase di esecuzione. In Microsoft Visual Basic, ad esempio, l'occorrenza di un errore specifico di ADO attiverà un evento On Error e verrà visualizzato nell'oggetto Error. Per un elenco completo degli errori ADO, consulta l'argomento ErrorValueEnum.

È possibile leggere le proprietà di un oggetto Error per ottenere dettagli specifici su ogni errore, tra cui:

  • Proprietà Description, che contiene il testo dell'errore. Si tratta della proprietà predefinita.

  • Proprietà Number , che contiene il valore long integer della costante di errore.

  • Proprietà Source , che identifica l'oggetto che ha generato l'errore. Ciò è particolarmente utile quando sono presenti diversi oggetti Error nella raccolta Errors dopo una richiesta a un'origine dati.

  • Proprietà SQLState e NativeError , che forniscono informazioni dalle origini dati SQL.

Quando si verifica un errore del provider, viene inserito nella raccolta Errors dell'oggetto Connection. ADO supporta la restituzione di più errori da una singola operazione ADO per consentire informazioni sugli errori specifiche del provider. Per ottenere queste informazioni dettagliate sugli errori in un gestore degli errori, utilizzare le funzionalità appropriate di intercettazione degli errori del linguaggio o dell'ambiente in uso, quindi utilizzare cicli annidati per enumerare le proprietà di ogni oggetto Error nella raccolta Errors.

Nota

Utenti di Microsoft Visual Basic e VBScript Se non è presente alcun oggetto Connection valido, sarà necessario recuperare le informazioni sull'errore dall'oggetto Error.

Proprio come fanno i provider, ADO cancella l'oggetto Informazioni errore OLE prima di effettuare una chiamata che potrebbe generare un nuovo errore del provider. Tuttavia, la raccolta Errors nell'oggetto Connection viene cancellata e popolata solo quando il provider genera un nuovo errore o quando viene chiamato il metodo Clear.

Alcuni metodi e proprietà restituiscono avvisi che vengono visualizzati come oggetti Error nella raccolta Errors, ma non interrompono l'esecuzione di un programma. Prima di chiamare i metodi Resync, UpdateBatch o CancelBatch su un oggetto Recordset; il metodo Open su un oggetto Connection; oppure impostare la proprietà Filter su un oggetto Recordset, chiamare il metodo Clear nella raccolta Errors. In questo modo, è possibile leggere la proprietà Count della raccolta Errors per verificare gli avvisi restituiti.

L'oggetto Error non è sicuro per lo scripting.

Questa sezione contiene l'argomento seguente.

Vedere anche

Esempio delle proprietà Description, HelpContext, HelpFile, NativeError, Number, Source e SQLState (VB)
Esempio delle proprietà Description, HelpContext, HelpFile, NativeError, Number, Source, e SQLState (VC++)
Oggetto Connection (ADO)
Raccolta Errors (ADO)
Appendice A: Provider