Error-Objekt
Enthält Details zu Datenzugriffsfehlern, die sich auf einen einzelnen Vorgang beziehen, der den Anbieter umfasst.
Bemerkungen
Jeder Vorgang mit ADO-Objekten kann einen oder mehrere Anbieterfehler generieren. Wenn jeder Fehler auftritt, werden mindestens ein Error-Objekte in der Errors Auflistung des Connection-Objekts platziert. Wenn ein anderer ADO-Vorgang einen Fehler generiert, wird die Errors -Auflistung gelöscht, und der neue Satz von Error -Objekten wird in der Errors -Auflistung platziert.
Anmerkung
Jedes Error -Objekt stellt einen bestimmten Anbieterfehler dar, nicht einen ADO-Fehler. ADO-Fehler werden für den Laufzeit-Ausnahmebehandlungsmechanismus verfügbar gemacht. Beispielsweise löst das Auftreten eines ADO-spezifischen Fehlers in Microsoft Visual Basic ein On Error-Ereignis aus und wird im Error-Objekt angezeigt. Eine vollständige Liste der ADO-Fehler finden Sie im Thema ErrorValueEnum.
Sie können die Eigenschaften eines Error Objekts lesen, um bestimmte Details zu jedem Fehler abzurufen, einschließlich der folgenden:
Die Description-Eigenschaft, die den Text des Fehlers enthält. Dies ist die Standardeigenschaft.
Die Number-Eigenschaft, die den Long ganzzahligen Wert der Fehlerkonstante enthält.
Die Source-Eigenschaft, die das Objekt identifiziert, das den Fehler ausgelöst hat. Dies ist besonders nützlich, wenn Sie mehrere Error-Objekte in der Errors Auflistung nach einer Anforderung an eine Datenquelle haben.
Die eigenschaften SQLState und NativeError, die Informationen aus SQL-Datenquellen bereitstellen.
Wenn ein Anbieterfehler auftritt, wird er in der Errors Auflistung des Connection-Objekts platziert. ADO unterstützt die Rückgabe mehrerer Fehler durch einen einzelnen ADO-Vorgang, um Fehlerinformationen zuzulassen, die für den Anbieter spezifisch sind. Um diese umfangreichen Fehlerinformationen in einem Fehlerhandler abzurufen, verwenden Sie die entsprechenden Fehlerfangfeatures der Sprache oder Umgebung, mit der Sie arbeiten, und verwenden Sie dann geschachtelte Schleifen, um die Eigenschaften der einzelnen Error-Objekts in der Errors-Auflistung auflisten.
Anmerkung
Microsoft Visual Basic- und VBScript-Benutzer Wenn kein gültiges Connection-Objekt vorhanden ist, müssen Sie Fehlerinformationen aus dem Error-Objekt abrufen.
Genau wie bei Anbietern ADO werden die OLE-Fehlerinformationen-Objekts gelöscht, bevor ein Aufruf ausgeführt wird, der möglicherweise einen neuen Anbieterfehler generieren kann. Die Errors Auflistung für das Connection-Objekt wird jedoch gelöscht und nur ausgefüllt, wenn der Anbieter einen neuen Fehler generiert oder wenn die Clear-Methode aufgerufen wird.
Einige Eigenschaften und Methoden geben Warnungen zurück, die als Error-Objekte in der Errors Auflistung angezeigt werden, aber die Ausführung eines Programms nicht anhalten. Bevor Sie die Methoden Resync, UpdateBatchoder CancelBatch- für ein Recordset -Objekt aufrufen; die Open-Methode für ein Connection-Objekt; oder legen Sie die Filter-Eigenschaft für ein Recordset--Objekt fest, rufen Sie die Clear-Methode für die Errors-Auflistung auf. Auf diese Weise können Sie die eigenschaft Count der Errors Collection lesen, um auf zurückgegebene Warnungen zu testen.
Das Error-Objekt ist für skripterstellung nicht sicher.
Dieser Abschnitt enthält das folgende Thema.
Siehe auch
Description-, HelpContext-, HelpFile-, NativeError-, Number-, Source- und SQLState-Eigenschaft (Beispiel) (VB)
Description-, HelpContext-, HelpFile-, NativeError-, Number-, Source- und SQLState-Eigenschaft (Beispiel) (VC++)
Connection-Objekt (ADO)
Errors-Auflistung (ADO)
Anhang A: Anbieter