CDatabase-Klasse

Artikel
06/10/2015

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

class CDatabase : public CObject

Mitglieder

Öffentliche Konstruktoren

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

Ö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.

Ö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.

Hinweis

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.