Error-Objekt (ADO)

Gilt für: Access 2013, Office 2013

Enthält Details zu Datenzugriffsfehlern, die sich auf eine einzelne Operation beziehen, die den Anbieter betrifft.

Hinweise

Jeder Vorgang, an dem ADO-Objekte beteiligt sind, kann mindestens einen Anbieterfehler generieren. Sobald ein Fehler auftritt, wird mindestens ein Error-Objekt in der Errors-Auflistung des Connection-Objekts eingefügt. Wenn ein anderer ADO-Vorgang einen Fehler erzeugt, wird die Errors -Auflistung gelöscht, und die neue Gruppe der Error -Objekte wird in die Errors -Auflistung übernommen.

Hinweis

Jedes Error-Objekt stellt einen bestimmten Anbieterfehler dar und nicht einen ADO-Fehler. ADO-Fehler unterliegen dem Laufzeit-Fehlerbehandlungsmechanismus. In Microsoft Visual Basic löst das Auftreten eines ADO-spezifischen Fehlers z. B. ein On Error-Ereignis aus, und der Fehler wird im Error-Objekt angezeigt. Eine vollständige Liste der ADO-Fehler finden Sie unter dem Thema ErrorValueEnum.

Sie können die Eigenschaften eines Error -Objekts lesen, um die folgenden Details über die einzelnen Fehler zu erhalten:

• Die Description-Eigenschaft, die den Fehlertext enthält. Dies ist die Standardeigenschaft.

• Die Number-Eigenschaft, die den Long -Ganzzahlwert der Fehlerkonstanten enthält.

• Die Source-Eigenschaft, die das Objekt identifiziert, das den Fehler ausgelöst hat. Diese Eigenschaft ist besonders nützlich, wenn nach einer Abfrage einer Datenquelle mehrere Error -Objekte in der Errors -Auflistung enthalten sind.

• Die Eigenschaften SQLState und NativeError, die Informationen über SQL-Datenquellen bereitstellen.

Wenn ein Anbieterfehler auftritt, wird er in die Errors -Auflistung des Connection -Objekts aufgenommen. ADO unterstützt die Rückgabe mehrerer Fehler durch einen einzelnen ADO-Vorgang, um anbieterspezifische Fehlerinformationen zu gestatten. Verwenden Sie die zutreffenden Fehlerbehandlungsfeatures der Sprache oder Umgebung, und durchlaufen Sie dann die Eigenschaften der einzelnen Error -Objekte in der Errors -Auflistung in geschachtelten Schleifen, um diese ausführlichen Fehlerinformationen in einer Fehlerbehandlungsroutine zu erhalten.

Microsoft Visual Basic- und VBScript-BenutzerWenn kein gültiges Connection-Objekt vorhanden ist, müssen Sie Fehlerinformationen aus dem Error-Objekt abrufen.

Wie andere Anbieter löscht auch ADO das OLE Error Info -Objekt vor dem Ausführen eines Aufrufs, der potenziell einen neuen Anbieterfehler erzeugen könnte. Die Errors -Auflistung des Connection -Objekts wird jedoch gelöscht und nur dann aufgefüllt, wenn der Anbieter einen neuen Fehler erzeugt, oder wenn die Clear-Methode aufgerufen wird.

Von manchen Eigenschaften und Methoden werden Warnungen zurückgegeben, die als Error -Objekte in der Errors -Auflistung angezeigt werden, ohne dass die Ausführung eines Programms angehalten wird. Rufen Sie vor dem Aufrufen der Methoden Resync, UpdateBatch oder CancelBatch für ein Recordset-Objekt oder der Open-Methode für ein Connection -Objekt oder vor dem Festlegen der Filter-Eigenschaft für ein Recordset -Objekt die Clear -Methode für die Errors -Auflistung auf. Auf diese Weise können Sie die Count-Eigenschaft der Errors -Auflistung lesen, um auf zurückgegebene Warnungen zu testen.