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.