Oggetto di Errore

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

Osservazioni:

Qualsiasi operazione che coinvolge oggetti ADO può generare uno o più errori del provider. Quando si verifica un errore, uno o più oggetti Error vengono inseriti nella collezione Errors dell'oggetto Connection. Quando un'altra operazione ADO genera un errore, l'insieme Errors viene cancellato e il nuovo set di oggetti Error viene inserito nell'insieme Errors .

Annotazioni

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. Ad esempio, in Microsoft Visual Basic, 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, vedere l'argomento ErrorValueEnum .

È possibile leggere le proprietà di un oggetto Error per ottenere dettagli specifici su ogni errore, inclusi i seguenti:

• Proprietà Description che contiene il testo dell'errore. Questa è la proprietà predefinita.

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

• Proprietà Source , che identifica l'oggetto che ha generato l'errore. Ciò è particolarmente utile quando sono presenti diversi oggetti Error nell'insieme 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 nell'insieme 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 sull'errore in un gestore 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 nell'insieme Errors .

Annotazioni

Utenti di Microsoft Visual Basic e VBScript Se non è presente alcun oggetto Connection valido, sarà necessario recuperare 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, l'insieme Errors nell'oggetto Connection viene cancellato e popolato solo quando il provider genera un nuovo errore o quando viene chiamato il metodo Clear .

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

L'oggetto Error non è sicuro per la creazione di script.

Questa sezione contiene l'argomento seguente.

• Proprietà, metodi ed eventi dell'oggetto Error

Vedere anche

Descrizione, HelpContext, HelpFile, NativeError, Number, Source e Proprietà SQLState (VB)
Descrizione, HelpContext, HelpFile, NativeError, Number, Source e Proprietà SQLState Esempio (VC++)
dell'oggetto Connection (ADO)
Insieme Errors (ADO)
Appendice A: Fornitori