Freigeben über


CDatabase-Klasse

Stellt eine Verbindung zu einer Datenquelle dar, durch die Sie die Datenquelle ausgeführt werden können.

class CDatabase : public CObject

Mitglieder

2dhc1abk.collapse_all(de-de,VS.110).gifÖffentliche Konstruktoren

Name

Description

CDatabase::CDatabase

Erstellt ein CDatabase-Objekt.Sie müssen das Objekt initialisieren, indem Sie OpenEx oder Öffnen aufrufen.

2dhc1abk.collapse_all(de-de,VS.110).gifÖffentliche Methoden

Name

Description

CDatabase::BeginTrans

Startet eine Transaktion "" - Eine umkehrbare Aufrufe AddNew, zu Bearbeiten, zu Löschen und zu Update-Memberfunktionen der Klasse CRecordset auf der verbundenen Datenquelle.Die Datenquelle muss Transaktionen unterstützen, damit BeginTrans jeden Auswirkungen hat.

CDatabase::BindParameters

Vor dem Aufrufen von CDatabase::ExecuteSQL ermöglicht das Bindungsparametern.

CDatabase::Cancel

Bricht einen asynchronen Vorgang oder einen Prozess aus einem zweiten Thread ab.

CDatabase::CanTransact

Gibt Wert ungleich 0 zurück, wenn die Datenquelle Transaktionen unterstützt.

CDatabase::CanUpdate

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

CDatabase::Close

Schließt die Datenquellenverbindung.

CDatabase::CommitTrans

Schließt eine Transaktion ab, die von BeginTrans gestartet wird.Befehle in der Transaktion, die die Datenquelle ändern, werden durchgeführt.

CDatabase::ExecuteSQL

Führt eine SQL-Anweisung aus.Keine Datensätze werden zurückgegeben.

CDatabase::GetBookmarkPersistence

Identifiziert die Vorgänge, durch die Lesezeichen auf Recordsetobjekten erhalten bleiben.

CDatabase::GetConnect

Gibt die ODBC-Verbindungszeichenfolge zurück, die verwendet wird, um das CDatabase-Objekt einer Datenquelle herzustellen.

CDatabase::GetCursorCommitBehavior

Identifiziert die Auswirkungen des eines Commits führens einer Transaktion auf einem geöffneten Recordset-Objekt.

CDatabase::GetCursorRollbackBehavior

Identifiziert den Auswirkungen Zurücksetzen einer Transaktion auf einem geöffneten Recordset-Objekt.

CDatabase::GetDatabaseName

Gibt den Namen der Datenbank derzeit zurück.

CDatabase::IsOpen

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

CDatabase::OnSetOptions

Aufgerufen durch das Framework, um Standardverbindungsoptionen festzulegen.Die Standardimplementierung legt den Abfragentimeoutwert fest.Sie können diese Optionen vorzeitig wiederherstellen, indem Sie SetQueryTimeout aufrufen.

CDatabase::Open

Richtet eine Verbindung zu einer Datenquelle ein (über einen ODBC-Treiber).

CDatabase::OpenEx

Richtet eine Verbindung zu einer Datenquelle ein (über einen ODBC-Treiber).

CDatabase::Rollback

Rückseitenänderungen vorgenommen während der aktuellen Transaktion.Die Datenquelle wird auf den vorherigen Zustand zurück, wie am BeginTrans Aufruf definiert, unverändert.

CDatabase::SetLoginTimeout

Legt die Anzahl der Sekunden nach von Datenquellenverbindungsversuchswillenstimeout fest.

CDatabase::SetQueryTimeout

Legt die Anzahl der Sekunden nach von Datenbankabfragevorgangswillenstimeout fest.Wirkt sich alle folgende Recordset Öffnen, AddNew, Bearbeiten und Löschen Aufrufe.

2dhc1abk.collapse_all(de-de,VS.110).gifÖffentliche Datenmember

Name

Description

CDatabase::m_hdbc

Verbindungshandle der Open Database Connectivity (ODBC) an eine Datenquelle.Typ HDBC.

Hinweise

Eine Datenquelle ist eine bestimmte Instanz von Daten, die von oder Datenbankmanagementsystem (DBMS) gehostet werden.Zu den Microsoft SQL Server, Microsoft Access-, Borland-dBASE und xBASE.Sie können eine oder mehrere CDatabase-Objekte besitzen, die in der Anwendung aktiv sind.

HinweisHinweis

Wenn Sie mit den Datenzugriffsobjekten (DAO) Klasse anstatt die Klassen der Open Database Connectivity (ODBC), Verwendungsklasse CDaoDatabase stattdessen arbeiten.Weitere Informationen finden Sie im Artikel Übersicht: Datenbank-Programmierung.

Um CDatabase zu verwenden, erstellen Sie ein CDatabase-Objekt und Aufrufen ihrer OpenEx-Memberfunktion auf.Dadurch wird eine Verbindung.Wenn Sie dann CRecordset-Objekte für das Funktionieren auf der verbundenen Datenquelle erstellen, führen Sie den Recordsetkonstruktor ein Zeiger auf dem CDatabase-Objekt.Wenn Sie beenden, die Verbindung zu verwenden, rufen Sie die Memberfunktion auf Schließen und zerstören Sie das CDatabase-Objekt.Schließen schließt alle Recordsets, die Sie vorher nicht geschlossen haben.

Weitere Informationen zu CDatabase, finden Sie in Artikel Datenquelle (ODBC) und Übersicht: Datenbank-Programmierung.

Vererbungshierarchie

CObject

CDatabase

Anforderungen

Header: afxdb.h

Siehe auch

Referenz

CObject-Klasse

Hierarchien-Diagramm

CRecordset-Klasse