CDaoDatabase-Klasse

Stellt eine Verbindung zu einer Datenbank dar, durch die Sie die Daten angewendet werden können.

class CDaoDatabase : public CObject

Mitglieder

34fa51ss.collapse_all(de-de,VS.110).gifÖffentliche Konstruktoren

Name

Description

CDaoDatabase::CDaoDatabase

Erstellt ein CDaoDatabase-Objekt.Rufen Sie Öffnen auf, um das Objekt zu einer Datenbank herzustellen.

34fa51ss.collapse_all(de-de,VS.110).gifÖffentliche Methoden

Name

Description

CDaoDatabase::CanTransact

Gibt Wert ungleich 0 wenn die Datenbankstütztransaktionen zurück.

CDaoDatabase::CanUpdate

Gibt Wert ungleich 0 zurück, wenn das Objekt CDaoDatabase aktualisierbar ist nicht (schreibgeschützt).

CDaoDatabase::Close

Schließt die Datenbankverbindung.

CDaoDatabase::Create

Erstellt das zugrunde liegende DAO-Datenbank-Objekt und initialisiert das CDaoDatabase-Objekt.

CDaoDatabase::CreateRelation

Definiert eine neue Beziehung zwischen den Tabellen in der Datenbank.

CDaoDatabase::DeleteQueryDef

Löscht ein Querydef-Objekt, das in der Querydefauflistung der Datenbank gespeichert wird.

CDaoDatabase::DeleteRelation

Löscht eine vorhandene Beziehung zwischen Tabellen in der Datenbank.

CDaoDatabase::DeleteTableDef

Löscht die Definition einer Tabelle in der Datenbank.Hierdurch wird die tatsächliche Tabelle mit sämtlichen Daten.

CDaoDatabase::Execute

Führt eine Aktionsabfrage aus.Aufrufen von Execute für eine Abfrage gibt, dass sich eine Ausnahme auslöst ergibt.

CDaoDatabase::GetConnect

Gibt die Verbindungszeichenfolge zurück, die verwendet wird, um das CDaoDatabase-Objekt zu einer Datenbank herzustellen.Wird für ODBC.

CDaoDatabase::GetName

Gibt den Namen der Datenbank derzeit zurück.

CDaoDatabase::GetQueryDefCount

Gibt die Anzahl der Abfragen zurück, die für die Datenbank definiert sind.

CDaoDatabase::GetQueryDefInfo

Gibt Informationen über eine bestimmte Abfrage zurück, die in der Datenbank definiert ist.

CDaoDatabase::GetQueryTimeout

Gibt die Anzahl der Sekunden nach von Datenbankabfragevorgangswillenstimeout zurück.Wirkt sich alle geöffneten nachfolgendes, fügt neue, Aktualisieren und Bearbeitungsvorgänge und andere Vorgänge auf ODBC-Datenquellen (nur) wie Execute Aufrufen hinzu.

CDaoDatabase::GetRecordsAffected

Gibt die Anzahl der Datensätze zurück, die durch das letzte Update, Bearbeiten betroffen sind oder fügt Vorgang oder durch einen Aufruf Execute hinzu.

CDaoDatabase::GetRelationCount

Gibt die Anzahl von Verbindungen zurück, die zwischen Tabellen in der Datenbank definiert werden.

CDaoDatabase::GetRelationInfo

Gibt Informationen über eine bestimmte Beziehung zurück, die zwischen Tabellen in der Datenbank definiert ist.

CDaoDatabase::GetTableDefCount

Gibt die Anzahl der Tabellen zurück, die in der Datenbank definiert werden.

CDaoDatabase::GetTableDefInfo

Gibt Informationen über eine bestimmte Tabelle in der Datenbank zurück.

CDaoDatabase::GetVersion

Gibt die Version des Datenbankmoduls zurück, das der Datenbank zugeordnet ist.

CDaoDatabase::IsOpen

Gibt Wert ungleich 0 zurück, wenn das Objekt gegenwärtig CDaoDatabase mit einer Datenbank verbunden ist.

CDaoDatabase::Open

Richtet eine Verbindung mit einer Datenbank her.

CDaoDatabase::SetQueryTimeout

Legt die Anzahl von Sekunden fest, nach der Datenbankabfragevorgänge (nur auf ODBC-Datenquellen) Timeout.Wirkt sich alle geöffneten nachfolgendes, fügt neue, Aktualisierungs- und Löschvorgänge hinzu.

34fa51ss.collapse_all(de-de,VS.110).gifÖffentliche Datenmember

Name

Description

CDaoDatabase::m_pDAODatabase

Ein Zeiger auf den zugrunde liegenden DAO-Datenbank-Objekt.

CDaoDatabase::m_pWorkspace

Ein Zeiger auf CDaoWorkspace-Objekt, das die Datenbank enthält und sein Transaktionsleerzeichen definiert.

Hinweise

Informationen zu den unterstützten Datenbankformate, finden Sie die GetName-Memberfunktion.Sie können eine oder mehrere CDaoDatabase-Objekte besitzen, die in einem angegebenen "Arbeitsbereich aktiv sind," dargestellt durch eine CDaoWorkspace-Objekt.Der Arbeitsbereich verwaltet eine Auflistung offener Datenbankobjekte bei, die Datenbankauflistung aufgerufen.

HinweisHinweis

Die MFC-DAO-Datenbankklassen sind von den MFC-Datenbankklassen auf Grundlage ODBC unterschiedlich.Alle DAO-Datenbankklassen-Namen haben das Präfix "CDao".- Klasse CDaoDatabase stellt eine Schnittstelle, die zu der der ODBC-Klasse CDatabase ähnelt.Der Hauptunterschied liegt darin, dass CDatabase auf das DBMS von Open Database Connectivity (ODBC) und einen ODBC-Treiber für dieses DBMS zugreift.CDaoDatabase greift auf Daten über ein Datenzugriffsobjekt (DAO) auf Grundlage das Microsoft Jet-Datenbankmodul zu.Im Allgemeinen sind die MFC-Klassen auf Grundlage DAO besser geeignet als die MFC-Klassen auf Grundlage ODBC; die DAO-basierten Klassen machen die Daten ein und enthalten durch ODBC-Treiber, über ein eigenes Datenbankmodul.Die DAO-basierten Klassen unterstützen auch Operationen der Datendefinitionssprache (Data Definition Language), wie das Hinzufügen von Tabellen zu Klassen, ohne zu müssen, DAO direkt aufzurufen.

Verwendung

Sie können Datenbankobjekte implizit erstellen, wenn Sie Recordset-Objekte erstellen.Sie können jedoch Datenbankobjekte auch explizit erstellen.Um eine vorhandene Datenbank mit CDaoDatabase explizit zu verwenden, führen Sie eine der folgenden Aktionen aus:

  • Erstellen Sie ein CDaoDatabase-Objekt und einen Zeiger an einem geöffneten CDaoWorkspace-Objekt.

  • Oder erstellen Sie ein CDaoDatabase-Objekt, ohne den Arbeitsbereich anzugeben (MFC erstellt ein temporäres Arbeitsbereichsobjekt).

Um eine neue Microsoft Jet-Datenbanken (.MDB) zu erstellen, erstellen Sie ein CDaoDatabase-Objekt und Aufrufen ihrer Erstellen Sie-Memberfunktion auf.Rufen Sie Öffnennicht nach Create auf.

Um eine vorhandene Datenbank zu öffnen, erstellen Sie ein CDaoDatabase-Objekt und Aufrufen ihrer Öffnen Sie-Memberfunktion auf.

Alle Techniken fügt das DAO-Datenbank-Objekt zu Datenbanken Auflistung des Arbeitsbereichs an und öffnet eine Verbindung mit den Daten.Wenn Sie dann CDaoRecordset, CDaoTableDef oder CDaoQueryDef-Objekte für das Funktionieren auf der verbundenen Datenbank erstellen, führen Sie die Konstruktoren für diese Objekte ein Zeiger auf dem CDaoDatabase-Objekt.Wenn Sie beenden, die Verbindung zu verwenden, rufen Sie die Memberfunktion auf Schließen Sie und zerstören Sie das CDaoDatabase-Objekt.Schließen schließt alle Recordsets, die Sie vorher nicht geschlossen haben.

Transaktionen

Datenbanktransaktionsverarbeitung wird auf der Arbeitsbereichsebene angegeben - finden Sie die BeginTrans, CommitTrans und Rollback-Memberfunktionen der Klasse CDaoWorkspace.

ODBC-Verbindungen

Es wird empfohlen, mit ODBC-Datenquellen besteht darin, externe Tabellen einer Datenbank Microsoft Jet-Datenbanken (.MDB) anfügen.

Auflistungen

Jede Datenbank behält seine eigene Auflistungen tabledef-, Querydef, Recordset und Beziehungsobjekte bei.- Klasse CDaoDatabase stellt Memberfunktionen zur Bearbeitung dieser Objekte.

HinweisHinweis

Die Objekte werden in DAO, nicht im MFC-Datenbankobjekt gespeichert.MFC stellt Klassen für tabledef-, Querydef und Recordset-Objekte jedoch nicht für Beziehungsobjekte bereit.

Vererbungshierarchie

CObject

CDaoDatabase

Anforderungen

Header: afxdao.h

Siehe auch

Referenz

CObject-Klasse

Hierarchien-Diagramm

CDaoWorkspace-Klasse

CDaoRecordset-Klasse

CDaoTableDef-Klasse

CDaoQueryDef-Klasse

CDatabase-Klasse

CDaoExceptions-Klasse