CDaoException-Klasse

Stellt eine Ausnahmebedingung dar, die von MFC-Datenbankklassen in Bezug auf Datenzugriffsobjekte (DAOs) ausgelöst wird.

Syntax

class CDaoException : public CException

Member

Öffentliche Konstruktoren

Öffentliche Methoden

Öffentliche Datenmember

Hinweise

Die Klasse enthält öffentliche Datenmmber, mit denen Sie die Ursache der Ausnahme ermitteln können. CDaoException Objekte werden von Memberfunktionen der DAO-Datenbankklassen erstellt und ausgelöst.

Sie können auf Ausnahmeobjekte innerhalb des Gültigkeitsbereichs eines CATCH-Ausdrucks zugreifen. Sie können Objekte auch aus Ihrem eigenen Code mit der globalen AfxThrowDaoException-Funktion auslösenCDaoException.

In MFC werden alle DAO-Fehler als Ausnahmen vom Typ CDaoExceptionausgedrückt. Wenn Sie eine Ausnahme dieses Typs abfangen, können Sie Memberfunktionen verwenden CDaoException , um Informationen aus allen DAO-Fehlerobjekten abzurufen, die in der Errors-Auflistung des Datenbankmoduls gespeichert sind. Wenn jeder Fehler auftritt, werden mindestens ein Fehlerobjekt in der Errors-Auflistung platziert. (Normalerweise enthält die Auflistung nur ein Fehlerobjekt. Wenn Sie eine ODBC-Datenquelle verwenden, erhalten Sie wahrscheinlich mehrere Fehlerobjekte.) Wenn ein anderer DAO-Vorgang einen Fehler generiert, wird die Errors-Auflistung gelöscht, und das neue Fehlerobjekt wird in der Errors-Auflistung platziert. DAO-Vorgänge, die keinen Fehler generieren, haben keine Auswirkungen auf die Errors-Auflistung.

Informationen zu DAO-Fehlercodes finden Sie in der Datei DAOERR.H. Verwandte Informationen finden Sie im Thema "Auffangbare Datenzugriffsfehler" in der DAO-Hilfe.

Weitere Informationen zur Ausnahmebehandlung im Allgemeinen oder zu CDaoException Objekten finden Sie in den Artikeln Exception Handling (MFC) und Exceptions: Database Exceptions. Der zweite Artikel enthält Beispielcode, der die Ausnahmebehandlung in DAO veranschaulicht.

Vererbungshierarchie

CObject

CException

CDaoException

Anforderungen

Header: afxdao.h

CDaoException::CDaoException

Erstellt ein CDaoException-Objekt.

CDaoException();

Hinweise

Ordinarily, the framework creates exception objects when its code throws an exception. Sie müssen nur selten ein Ausnahmeobjekt explizit erstellen. Wenn Sie einen CDaoException aus Ihrem eigenen Code auslösen möchten, rufen Sie die globale Funktion AfxThrowDaoException auf.

Möglicherweise möchten Sie jedoch explizit ein Ausnahmeobjekt erstellen, wenn Sie direkte Aufrufe an DAO über die DAO-Schnittstellenzeiger ausführen, die MFC-Klassen kapseln. In diesem Fall müssen Sie möglicherweise Fehlerinformationen aus DAO abrufen. Angenommen, ein Fehler tritt in DAO auf, wenn Sie eine DAO-Methode über die DAODatabases-Schnittstelle für die Databases-Auflistung eines Arbeitsbereichs aufrufen.

So rufen Sie die DAO-Fehlerinformationen ab

1. Konstruieren Sie ein CDaoException-Objekt.

2. Rufen Sie die GetErrorCount-Memberfunktion des Ausnahmeobjekts auf, um zu bestimmen, wie viele Fehlerobjekte in der Errors-Auflistung des Datenbankmoduls enthalten sind. (Normalerweise nur eine, es sei denn, Sie verwenden eine ODBC-Datenquelle.)

3. Rufen Sie die GetErrorInfo-Memberfunktion des Ausnahmeobjekts auf, um jeweils ein bestimmtes Fehlerobjekt nach Index in der Auflistung über das Ausnahmeobjekt abzurufen. Stellen Sie sich das Ausnahmeobjekt als Proxy für ein DAO-Fehlerobjekt vor.

4. Untersuchen Sie die aktuelle CDaoErrorInfo-Struktur, die GetErrorInfo im m_pErrorInfo-Datenmemm zurückgegeben wird. Seine Mitglieder enthalten Informationen zum DAO-Fehler.

5. Wiederholen Sie bei einer ODBC-Datenquelle die Schritte 3 und 4 nach Bedarf, um weitere Fehlerobjekte anzuzeigen.

6. Wenn Sie das Ausnahmeobjekt auf dem Heap erstellt haben, löschen Sie es mit dem delete Operator, wenn Sie fertig sind.

Weitere Informationen zum Behandeln von Fehlern in den MFC DAO-Klassen finden Sie im Artikel Ausnahmen: Datenbank exceptions.

CDaoException::GetErrorCount

Rufen Sie diese Memberfunktion auf, um die Anzahl der DAO-Fehlerobjekte in der Errors-Auflistung des Datenbankmoduls abzurufen.

short GetErrorCount();

Rückgabewert

Die Anzahl der DAO-Fehlerobjekte in der Errors-Auflistung des Datenbankmoduls.

Hinweise

Diese Informationen sind nützlich, um die Errors-Auflistung zu durchlaufen, um jedes oder mehrere DAO-Fehlerobjekte in der Auflistung abzurufen. Rufen Sie zum Abrufen eines Fehlerobjekts nach Index oder DAO-Fehlernummer die GetErrorInfo-Memberfunktion auf.

CDaoException::GetErrorInfo

Gibt Fehlerinformationen zu einem bestimmten Fehlerobjekt in der Errors -Auflistung zurück.

void GetErrorInfo(int nIndex);

Parameter

nIndex
Der Index der Fehlerinformationen in der Errors-Auflistung des Datenbankmoduls für die Suche nach Index.

Hinweise

Rufen Sie diese Memberfunktion auf, um die folgenden Arten von Informationen zur Ausnahme abzurufen:

• Fehlercode

• Quelle

• Beschreibung

• Hilfedatei

• Hilfekontext

GetErrorInfo speichert die Informationen im Datenelement des Ausnahmeobjekts m_pErrorInfo . Eine kurze Beschreibung der zurückgegebenen Informationen finden Sie unter m_pErrorInfo. Wenn Sie eine Ausnahme vom Typ CDaoException erfassen, die von MFC ausgelöst wird, wird das m_pErrorInfo Element bereits ausgefüllt. Wenn Sie sich dafür entscheiden, DAO direkt aufzurufen, müssen Sie die Memberfunktion des Ausnahmeobjekts GetErrorInfo selbst aufrufen, um sie auszufüllen m_pErrorInfo. Eine ausführlichere Beschreibung finden Sie in der CDaoErrorInfo-Struktur .

Informationen zu DAO-Ausnahmen und Beispielcode finden Sie im Artikel "Ausnahmen: Datenbank exceptions".

CDaoException::m_nAfxDaoError

Enthält einen erweiterten MFC-Fehlercode.

Hinweise

Dieser Code wird in Fällen bereitgestellt, in denen eine bestimmte Komponente der MFC DAO-Klassen fehlerhaft ist.

Dabei sind folgende Werte möglich:

• NO_AFX_DAO_ERROR Der letzte Vorgang hat keinen erweiterten MFC-Fehler verursacht. Der Vorgang könnte jedoch andere Fehler von DAO oder OLE erzeugt haben, daher sollten Sie m_pErrorInfo und möglicherweise m_scode überprüfen.

• AFX_DAO_ERROR_ENGINE_INITIALIZATION MFC konnte das Microsoft Jet-Datenbankmodul nicht initialisieren. OLE konnte möglicherweise nicht initialisiert werden, oder es war unmöglich, eine Instanz des DAO-Datenbankmodulobjekts zu erstellen. Diese Probleme deuten in der Regel auf eine fehlerhafte Installation von DAO oder OLE hin.

• AFX_DAO_ERROR_DFX_BIND Eine Adresse, die in einem DAO-Datensatzfeldaustausch (DFX)-Funktionsaufruf verwendet wird, ist nicht vorhanden oder ungültig (die Adresse wurde nicht zum Binden von Daten verwendet). Möglicherweise haben Sie eine ungültige Adresse in einem DFX-Aufruf übergeben, oder die Adresse ist zwischen DFX-Vorgängen ungültig geworden.

• AFX_DAO_ERROR_OBJECT_NOT_OPEN Sie haben versucht, ein Recordset basierend auf einem Querydef- oder tabledef-Objekt zu öffnen, das sich nicht in einem geöffneten Zustand befand.

CDaoException::m_pErrorInfo

Enthält einen Zeiger auf eine CDaoErrorInfo Struktur, die Informationen zum DAO-Fehlerobjekt bereitstellt, das Sie zuletzt abgerufen haben, indem Sie GetErrorInfo aufrufen.

Hinweise

Dieses Objekt enthält die folgenden Informationen:

Ausführliche Informationen zu den im Objekt enthaltenen Informationen finden Sie in CDaoErrorInfo der CDaoErrorInfo-Struktur .

CDaoException::m_scode

Enthält einen Wert vom Typ SCODE , der den Fehler beschreibt.

Hinweise

Dies ist ein OLE-Code. Sie müssen diesen Wert nur selten verwenden, da in fast allen Fällen spezifischere MFC- oder DAO-Fehlerinformationen in den anderen CDaoException Datenmitgliedern zur Verfügung stehen.

Informationen zu SCODE finden Sie im Thema Struktur von OLE-Fehlercodes im Windows SDK. Der SCODE-Datentyp ist dem HRESULT-Datentyp zugeordnet.

Siehe auch

CException-Klasse
Hierarchiediagramm