Freigeben über


CDaoWorkspace-Klasse

Verwaltet eine benannte, kennwortgeschützte, Datenbanksitzung von der Anmeldung, um, durch einen einzelnen Benutzer abzumelden.

class CDaoWorkspace : public CObject

Mitglieder

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

Name

Description

CDaoWorkspace::CDaoWorkspace

Erstellt ein Arbeitsbereichsobjekt.Danach Aufruf Create oder Öffnen.

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

Name

Description

CDaoWorkspace::Append

Fügt einen neu erstellten Arbeitsbereich mit der Arbeitsbereichsauflistung des Datenbankmoduls an.

CDaoWorkspace::BeginTrans

Beginnt eine neue Transaktion, die für alle Datenbanken gilt, die im Arbeitsbereich geöffnet sind.

CDaoWorkspace::Close

Schließt den Arbeitsbereich und alle Objekte, die sie enthält.Während Transaktionen zurückgesetzt.

CDaoWorkspace::CommitTrans

Schließt die aktuelle Transaktion ab und speichert die Änderungen.

CDaoWorkspace::CompactDatabase

Komprimiert (oder Duplikate) eine Datenbank.

CDaoWorkspace::Create

Erstellt ein neues DAO-Arbeitsbereichsobjekt.

CDaoWorkspace::GetDatabaseCount

Gibt die Anzahl der DAO-Datenbank-Objekten in der Datenbankauflistung des Arbeitsbereichs zurück.

CDaoWorkspace::GetDatabaseInfo

Gibt Informationen über eine bestimmte DAO-Datenbank zurück, die in der Datenbankauflistung des Arbeitsbereichs definiert ist.

CDaoWorkspace::GetIniPath

Gibt den Speicherort der Initialisierungseinstellungen des Microsoft Jet-Datenbankmoduls in der Windows-Registrierung zurück.

CDaoWorkspace::GetIsolateODBCTrans

Gibt einen Wert zurück, der angibt, ob mehrere Transaktionen, die dieselbe ODBC-Datenquelle betreffen, über mehrere erzwungene Verbindungen zur Datenquelle befinden.

CDaoWorkspace::GetLoginTimeout

Gibt die Anzahl der Sekunden zurück, bevor ein Fehler auftritt, wenn der Benutzer versucht, auf eine ODBC-Datenbank anzumelden.

CDaoWorkspace::GetName

Gibt den benutzerdefinierten Namen für das Arbeitsbereichsobjekt zurück.

CDaoWorkspace::GetUserName

Gibt den angegebenen Benutzernamen zurück, als der Arbeitsbereich erstellt wurde.Dies ist der Name des Arbeitsbereichsbesitzers.

CDaoWorkspace::GetVersion

Gibt eine Zeichenfolge zurück, die die Version des Datenbankmoduls enthält, das mit dem Arbeitsbereich zugeordnet ist.

CDaoWorkspace::GetWorkspaceCount

Gibt die Anzahl der DAO-Arbeitsbereichsobjekten in der Arbeitsbereichsauflistung des Datenbankmoduls zurück.

CDaoWorkspace::GetWorkspaceInfo

Gibt Informationen zu einem angegebenen DAO-Arbeitsbereich zurück, der in der Arbeitsbereichsauflistung des Datenbankmoduls definiert ist.

CDaoWorkspace::Idle

Ermöglicht dem Datenbankmodul, um Tasks auszuführen.

CDaoWorkspace::IsOpen

Gibt Wert ungleich 0 (null) zurück, wenn der Arbeitsbereich geöffnet ist.

CDaoWorkspace::Open

Öffnet explizit ein Arbeitsbereichsobjekt, das mit Standardarbeitsbereich DAO zugeordnet ist.

CDaoWorkspace::RepairDatabase

Versucht, eine beschädigte Datenbank zu reparieren.

CDaoWorkspace::Rollback

Beendet die aktuelle Transaktion und speichert keine Änderungen.

CDaoWorkspace::SetDefaultPassword

Legt das Kennwort fest, unter dem das Datenbankmodul verwendet, wenn ein Arbeitsbereichsobjekt ohne ein bestimmtes Kennwort erstellt wird.

CDaoWorkspace::SetDefaultUser

Legt den Benutzernamen fest, dem das Datenbankmodul verwendet, wenn ein Arbeitsbereichsobjekt ohne einen bestimmten Benutzernamen erstellt wird.

CDaoWorkspace::SetIniPath

Legt den Speicherort der Initialisierungseinstellungen des Microsoft Jet-Datenbankmoduls in der Windows-Registrierung fest.

CDaoWorkspace::SetIsolateODBCTrans

Gibt an, ob mehrere Transaktionen, die dieselbe ODBC-Datenquelle betreffen, isoliert werden, indem mehrere Verbindungen zur Datenquelle erzwingt.

CDaoWorkspace::SetLoginTimeout

Legt die Anzahl von Sekunden fest, bevor ein Fehler auftritt, wenn der Benutzer versucht, einer ODBC-Datenquelle anzumelden.

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

Name

Description

CDaoWorkspace::m_pDAOWorkspace

verweist auf dem zugrunde liegenden DAO-Arbeitsbereichsobjekt.

Hinweise

In den meisten Fällen benötigen Sie nicht mehrere Arbeitsbereiche, und Sie müssen nicht, um explizite Arbeitsbereichsobjekte zu erstellen; Wenn Sie Datenbank und Recordset-Objekte öffnen, verwenden sie Standardarbeitsbereich DAO.Bei Bedarf können Sie mehrere Sitzungen gleichzeitig ausführen, indem Sie zusätzliche Arbeitsbereichsobjekte erstellen.Jedes Arbeitsbereichsobjekt kann geöffnete Datenbankobjekte der mehrere in einer eigenen Datenbankauflistung enthalten.In MFC ist ein Arbeitsbereich hauptsächlich ein Transaktions-Manager und gibt einen Satz von allen geöffneten Datenbanken im gleichen "Transaktionsleerzeichen" an.

HinweisHinweis

Die DAO-Datenbankklassen sind von den MFC-Datenbankklassen auf Grundlage Open Database Connectivity (ODBC) unterschiedlich.Alle DAO-Datenbankklassen-Namen haben ein Präfix "CDao".Im Allgemeinen sind die MFC-Klassen auf Grundlage DAO besser geeignet als die MFC-Klassen auf Grundlage ODBC.Die DAO-basierten Klassenzugangsdaten durch das Microsoft Jet-Datenbankmodul, einschließlich ODBC-Treiber.Sie unterstützen auch Operationen der Datendefinitionssprache (Data Definition Language), wie das Erstellen von Datenbanken und Hinzufügen von Tabellen und Feldern zu Klassen, ohne zu müssen, DAO direkt aufzurufen.

Funktionen

- Klasse CDaoWorkspace stellt Folgendes:

  • Expliziter Zugriff nach Bedarf zu einem standardmäßigen Arbeitsbereich erstellt, durch das Initialisieren des Datenbankmoduls.Normalerweise Sie Standardarbeitsbereich der Verwendung DAO implizit durch das Erstellen der Datenbank und der Recordset-Objekte.

  • Ein Transaktionsleerzeichen, in dem alle Transaktionen auf Datenbanken gelten, die im Arbeitsbereich geöffnet sind.Sie können zusätzliche Arbeitsbereiche erstellen, um separate Transaktionsbereiche zu verwalten.

  • Eine Schnittstelle zu vielen Eigenschaften des zugrunde liegenden Microsoft Jet-Datenbankmoduls (siehe die statischen Memberfunktionen).Ein Arbeitsbereich oder das Aufrufen einer statischen Memberfunktion Öffnen oder Erstellen, bevor geöffnet, oder Erstellen, initialisiert das Datenbankmodul.

  • Zugriff auf die Arbeitsbereichsauflistung des Datenbankmoduls, mit der alle aktiven Arbeitsbereiche speichert, die ihm angefügt wurden.Sie können mit Arbeitsbereichen auch erstellen und bearbeiten, ohne sie aus der Auflistung.

Sicherheit

MFC implementiert nicht die Benutzer und Gruppen in Auflistungen DAO, die für Sicherheitskontrolle verwendet werden.Wenn Sie diese Aspekte von DAO benötigen, müssen Sie sie selbst über direkte Aufrufe DAO-Schnittstellen programmieren.Weitere Informationen finden Sie unter Technischer Hinweis 54.

Verwendung

Sie können Klasse CDaoWorkspace verwenden:

  • Öffnen Sie explizit den Standardarbeitsbereich.

    Normalerweise ist die Verwendung des Standardarbeitsbereich implizit - wenn Sie neue CDaoDatabase oder CDaoRecordset-Objekte öffnen.Möglicherweise müssen Sie jedoch explizit darauf zugreifen - beispielsweise, Datenbankmoduleigenschaften oder die Arbeitsbereichsauflistung zugreifen.Siehe "impliziten Verwendung von dem standardmäßigen Arbeitsbereich" unten.

  • Erstellen Sie neue Arbeitsbereiche.Rufen Sie Fügen Sie an auf, wenn Sie sie der Arbeitsbereichsauflistung hinzufügen möchten.

  • Öffnen Sie einen vorhandenen Arbeitsbereichs in der Arbeitsbereichsauflistung.

Das Erstellen eines neuen Arbeitsbereichs, der noch nicht in der Arbeitsbereichsauflistung vorhanden ist, wird unter der Erstellen Sie-Memberfunktion beschrieben.Arbeitsbereichsobjekte bestehen nicht auf eine Art von zwischen datababase Modulsitzungen weiter.Wenn die Anwendungslinks MFC statisch, die Anwendung beenden das Datenbankmodul nicht initialisiert.Wenn die Anwendungslinks dynamisch mit MFC, das Datenbankmodul nicht initialisiert wird, wenn die MFC-DLL entladen wird.

Die standardmäßigen Arbeitsbereich explizit öffnen oder das Öffnen eines vorhandenen Arbeitsbereichs in den zugeordneten Auflistung, wird auf der Geöffnet-Memberfunktion beschrieben.

Beenden Sie eine Arbeitsbereichssitzung, indem Sie den Arbeitsbereich mit der Abschluss-Memberfunktion schließen.Schließen schließt alle Datenbanken, die Sie vorher nicht geschlossen haben und setzt über nicht mit Commit bestätigten Transaktionen zurück.

Transaktionen

DAO verwaltet Transaktionen auf der Arbeitsbereichsebene; Daher gelten Transaktionen für ein Arbeitsbereich mit der geöffneten Datenbanken mehrere für alle Datenbanken zu.Wenn beispielsweise zwei Datenbanken nicht mit Commit bestätigte Updates haben und Sie CommitTrans aufrufen, werden alle Aktualisierungen übernommen.Wenn Sie Transaktionen zu einer einzelnen Datenbank beschränken möchten, benötigen Sie ein separates Arbeitsbereichsobjekt für sie.

Impliziter Verwendung von dem standardmäßigen Arbeitsbereich

Standardarbeitsbereich verwendet MFC aus DAO implizit unter folgenden Umständen:

  • Wenn Sie erstellen, ein neues Objekt CDaoDatabase jedoch so nicht durch ein vorhandenes Objekt CDaoWorkspace ausführen, erstellt ein temporäres MFC Arbeitsbereichsobjekt für Sie, das dem Standardarbeitsbereich DAO entspricht.Wenn Sie so für mehrere Datenbanken ausführen, werden alle Datenbankobjekte dem standardmäßigen Arbeitsbereich zugeordnet.Sie können auf den Arbeitsbereich einer Datenbank von einem CDaoDatabase Datenmember zugreifen.

  • Auch wenn ein CDaoRecordset-Objekt erstellen, ohne einen Zeiger auf ein Objekt CDaoDatabase anzugeben, MFC erstellt ein temporäres Datenbankobjekt und, durch Erweiterung, ein temporäres Arbeitsbereichsobjekt.Sie können die Datenbank eines Recordsets und indirekt auf den Arbeitsbereich, durch einen CDaoRecordset Datenmember zugreifen.

Andere Vorgänge

Andere Datenbankvorgänge werden auch, wie Reparatur einer beschädigten Datenbank oder Komprimieren einer Datenbank bereitgestellt.

Informationen über DAO direkt aufrufen und über DAO-Sicherheit, finden Sie unter Technischer Hinweis 54.

Vererbungshierarchie

CObject

CDaoWorkspace

Anforderungen

Header: afxdao.h

Siehe auch

Referenz

CObject-Klasse

Hierarchien-Diagramm

CDaoDatabase-Klasse

CDaoRecordset-Klasse

CDaoTableDef-Klasse

CDaoQueryDef-Klasse

CDaoExceptions-Klasse