Error-Objekt

  • Artikel

Enthält Details zu Datenzugriffsfehlern, die sich auf einen einzelnen Vorgang beziehen, der den Anbieter umfasst.

Bemerkungen

Jeder Vorgang, der ADO-Objekte betrifft, kann einen oder mehrere Anbieterfehler erzeugen. Für jeden auftretenden Fehler werden ein oder mehrere Fehlerobjekte in die Sammlung Error des Objekts Connection aufgenommen. Wenn eine andere ADO-Operation einen Fehler erzeugt, wird die Sammlung Errors geleert und der neue Satz von Fehlerobjekten wird in die Sammlung Errors eingefügt.

Hinweis

Jedes Error-Objekt steht für einen bestimmten Anbieterfehler, nicht für einen ADO-Fehler. ADO-Fehler unterliegen dem Mechanismus zur Behandlung von Ausnahmen während der Laufzeit. In Microsoft Visual Basic beispielsweise wird das Auftreten eines ADO-spezifischen Fehlers ein On Error-Ereignis auslösen und im Error-Objekt erscheinen. Eine vollständige Liste der ADO-Fehler finden Sie unter dem Thema ErrorValueEnum.

Sie können die Eigenschaften eines Error-Objekts lesen, um bestimmte Details zu den einzelnen Fehlern zu erfahren, darunter die folgenden:

  • Die Eigenschaft Description, die den Text des Fehlers enthält. Das ist die Standardeigenschaft.

  • Die Eigenschaft Number, die den Long-Integer-Wert der Fehlerkonstante enthält.

  • Die Eigenschaft Source, die das Objekt identifiziert, das den Fehler ausgelöst hat. Dies ist besonders nützlich, wenn Sie nach einer Anfrage an eine Datenquelle mehrere Error-Objekte in der Sammlung Errors haben.

  • Die Eigenschaften SQLState und NativeError, die Informationen aus SQL-Datenquellen liefern.

Wenn ein Anbieterfehler auftritt, wird er in der Sammlung Errors des Objekts Connection abgelegt. ADO unterstützt die Rückgabe von mehreren Fehlern durch eine einzige ADO-Operation, um anbieterspezifische Fehlerinformationen zu erhalten. Um diese umfangreichen Fehlerinformationen in einem Error-Handler zu erhalten, verwenden Sie die entsprechenden Fehlerverfolgungsfunktionen der Sprache oder Umgebung, mit der Sie arbeiten, und verwenden dann verschachtelte Schleifen, um die Eigenschaften der einzelnen Error-Objekte in der Sammlung Errors aufzuzählen.

Hinweis

Microsoft Visual Basic- und VBScript-Benutzer Wenn kein gültigesConnection-Objekt vorhanden ist, müssen Sie die Fehlerinformationen aus dem Error-Objekt abrufen.

Genau wie Provider löscht auch ADO das OLE Error Info-Objekt, bevor es einen Aufruf tätigt, der möglicherweise einen neuen Anbieterfehler erzeugen könnte. Die Sammlung Errors des Connection-Objekts wird jedoch erst geleert und aufgefüllt, wenn der Anbieter einen neuen Fehler generiert oder wenn die Methode Clear aufgerufen wird.

Einige Eigenschaften und Methoden geben Warnungen zurück, die als Error-Objekte in der Sammlung Errors erscheinen, aber die Ausführung eines Programms nicht anhalten. Bevor Sie die Methoden Resync, UpdateBatch oder CancelBatch für ein Recordset-Objekt, die Methode Open für ein Connection-Objekt oder die Eigenschaft Filter für ein Recordset-Objekt aufrufen, rufen Sie die Methode Clear für die Sammlung Errors auf. Auf diese Weise können Sie die Eigenschaft Count der Sammlung Errors lesen, um auf zurückgegebene Warnungen zu testen.

Das Error-Objekt ist für die Skripterstellung nicht sicher.

Dieser Abschnitt enthält das folgende Thema.

Weitere Informationen

Die Eigenschaften Description, HelpContext, HelpFile, NativeError, Number, Source und SQLState – Beispiel (VB)
Die Eigenschaften Description, HelpContext, HelpFile, NativeError, Number, Source und SQLState – Beispiel (VC++)
Connection-Objekt (ADO)
Errors-Collection (ADO)
Anhang A: Anbieter