Klasa CDaoWorkspace

Artykuł
02/27/2013

Zarządza sesji nazwany, chroniony hasłem bazę danych z logowania do wylogowania przez pojedynczego użytkownika.

class CDaoWorkspace : public CObject

Członkowie

Publiczne konstruktory

Nazwa	Opis
CDaoWorkspace::CDaoWorkspace	Konstrukcje obiektu obszaru roboczego.Następnie, wywoływać Tworzenie lub Otwórz.

Metody publiczne

Nazwa	Opis
CDaoWorkspace::Append	Nowo utworzony obszar roboczy dołącza do kolekcji obszary robocze aparatu bazy danych.
CDaoWorkspace::BeginTrans	Rozpoczyna nową transakcję, która ma zastosowanie do wszystkich baz danych otwartej w obszarze roboczym.
CDaoWorkspace::Close	Zamknięcie obszaru roboczego i wszystkie obiekty, które zawiera.Do czasu transakcji są przywracane.
CDaoWorkspace::CommitTrans	Kończy bieżącą transakcję i zapisuje zmiany.
CDaoWorkspace::CompactDatabase	Kompaktuje (lub inaczej powiela) bazy danych.
CDaoWorkspace::Create	Tworzy nowy obiekt DAO obszaru roboczego.
CDaoWorkspace::GetDatabaseCount	Zwraca liczbę obiektów bazy danych DAO w kolekcji bazy danych obszaru roboczego.
CDaoWorkspace::GetDatabaseInfo	Zwraca informacje o określonej bazy danych DAO zdefiniowane w kolekcji bazy danych obszaru roboczego.
CDaoWorkspace::GetIniPath	Zwraca ustawienia inicjalizacyjne aparatu lokalizację bazy danych Microsoft Jet w rejestrze systemu Windows.
CDaoWorkspace::GetIsolateODBCTrans	Zwraca wartość wskazującą, czy są izolowane za pośrednictwem wielu transakcji, które dotyczą tego samego źródła danych ODBC zmuszony wiele połączeń do źródła danych.
CDaoWorkspace::GetLoginTimeout	Zwraca liczbę sekund, zanim wystąpi błąd, gdy użytkownik próbuje zalogować się do bazy danych ODBC.
CDaoWorkspace::GetName	Zwraca nazwę użytkownika dla obiektu obszaru roboczego.
CDaoWorkspace::GetUserName	Zwraca nazwę użytkownika określone podczas tworzenia obszaru roboczego.Jest to nazwa właściciela obszaru roboczego.
CDaoWorkspace::GetVersion	Zwraca ciąg zawierający wersja aparatu bazy danych skojarzonych z obszaru roboczego.
CDaoWorkspace::GetWorkspaceCount	Zwraca liczbę obiektów DAO obszaru roboczego w kolekcji obszary robocze aparatu bazy danych.
CDaoWorkspace::GetWorkspaceInfo	Zwraca informacje dotyczące określonego obszaru roboczego DAO zdefiniowane w kolekcji obszary robocze aparatu bazy danych.
CDaoWorkspace::Idle	Umożliwia aparat bazy danych, aby wykonać zadania w tle.
CDaoWorkspace::IsOpen	Zwraca wartość niezerową, jeśli obszar roboczy jest otwarcie.
CDaoWorkspace::Open	Otwiera jawnie obiektu obszaru roboczego, skojarzone z obszaru roboczego domyślne dla obiektów DAO.
CDaoWorkspace::RepairDatabase	Próbuje naprawić uszkodzony bazy danych.
CDaoWorkspace::Rollback	Kończy bieżącą transakcję i nie zapisuje zmiany.
CDaoWorkspace::SetDefaultPassword	Ustawia hasło, które używa aparatu bazy danych podczas tworzenia obiektu obszaru roboczego bez określonego hasła.
CDaoWorkspace::SetDefaultUser	Ustawia nazwę użytkownika, który używa aparatu bazy danych podczas tworzenia obiektu obszaru roboczego bez określonej nazwy użytkownika.
CDaoWorkspace::SetIniPath	Ustawia ustawienia inicjalizacyjne aparatu lokalizację bazy danych Microsoft Jet w rejestrze systemu Windows.
CDaoWorkspace::SetIsolateODBCTrans	Określa, czy wiele transakcji, które dotyczą tego samego źródła danych ODBC są izolowane przez wymuszanie wiele połączeń do źródła danych.
CDaoWorkspace::SetLoginTimeout	Ustawia liczbę sekund, zanim wystąpi błąd, gdy użytkownik próbuje zalogować się do źródła danych ODBC.

Publiczne danych członków

Nazwa	Opis
CDaoWorkspace::m_pDAOWorkspace	Punkty do podstawowej obiektu DAO w obszarze roboczym.

Uwagi

W większości przypadków nie będzie potrzeby wielu obszarów roboczych i nie trzeba tworzyć obiekty jawne roboczego; Podczas otwierania obiektów bazy danych i rekordów używają roboczego domyślne dla obiektów DAO.Jednakże w razie potrzeby można uruchomić wiele sesji jednocześnie przez tworzenie obszaru roboczego dodatkowe obiekty.Każdy obiekt w obszarze roboczym może zawierać wiele obiektów otwórz bazę danych w kolekcji własnych baz danych.W MFC obszar roboczy jest przede wszystkim Menedżera transakcji, określając zestaw otwartych baz danych w tej samej "miejsca transakcji".

[!UWAGA]

Klasy bazy danych DAO różnią się od klasy bazy danych MFC oparte na Open Database Connectivity (ODBC).Wszystkie nazwy klasy bazy danych DAO mają prefiks "CDao".Zasadniczo klas MFC oparte na DAO są zdolne do niż klas MFC oparte na ODBC.Klasy DAO na dostęp do danych przez aparat bazy danych Microsoft Jet, w tym sterowników ODBC.Obsługują one operacji języka definicji danych (DDL), takich jak tworzenie baz danych i dodawanie tabel i pól za pośrednictwem klas, bez konieczności bezpośrednio wywołać DAO.

Możliwości

Klasa CDaoWorkspace zawiera następujące:

Dostęp, w razie potrzeby do domyślnego obszaru roboczego, utworzone przez inicjowanie aparatu bazy danych.Zwykle użyć DAO's domyślna przestrzeń robocza niejawnie przez tworzenie obiektów bazy danych i rekordów.
Miejsce transakcji, w którym transakcje stosuje się do wszystkich baz danych, Otwórz w obszarze roboczym.Można utworzyć dodatkowe obszary robocze do zarządzania transakcji oddzielne pomieszczenia.
Interfejs do wielu właściwości aparatu bazy danych Microsoft Jet podstawowej (zobacz funkcje członka statycznego).Otwierania lub tworzenia obszaru roboczego lub wywołanie funkcji członka statycznego przed Otwórz lub Utwórz, inicjuje aparatu bazy danych.
Dostęp do gromadzenia obszary robocze aparatu bazy danych, który przechowuje wszystkie obszary robocze aktywnego, które zostały dołączone do niego.Można tworzyć i pracować z obszarów roboczych bez dołączania ich do kolekcji.

Zabezpieczenia

MFC nie implementuje kolekcji użytkowników i grup w DAO, które są używane do kontroli bezpieczeństwa.Jeśli potrzebujesz tych aspektów DAO należy zaprogramować je samodzielnie poprzez bezpośrednie wywołania do interfejsów obiektów DAO.Aby uzyskać informacje, zobacz technicznej Uwaga 54.

Sposób użycia

Można użyć klasy CDaoWorkspace do:

Jawnie otworzyć domyślnego obszaru roboczego.

Korzystanie z obszaru roboczego domyślny jest zazwyczaj niejawna — podczas otwierania nowych CDaoDatabase lub CDaoRecordset obiektów.Ale trzeba jawnie dostęp — na przykład do właściwości aparatu bazy danych programu access lub kolekcji obszarów roboczych.Zobacz "Użycie domyślnego obszaru roboczego" poniżej.
Tworzenie nowych obszarów roboczych.Wywołanie Append , jeśli chcesz je dodać do kolekcji obszarów roboczych.
Otwieranie istniejącego obszaru roboczego w kolekcji obszarów roboczych.

Tworzenie nowego obszaru roboczego nie istnieje w kolekcji jest opisany w obszarach roboczych Tworzenie funkcji składowej.Obiekty w obszarze roboczym nie są zachowywane w jakikolwiek sposób między sesjami silnika datababase.Jeśli aplikacja statycznie łączy MFC, zakończenia stosowania uninitializes aparatu bazy danych.Aplikacja łączy się z MFC dynamicznie, aparat bazy danych jest niezainicjowany podczas biblioteki MFC DLL jest zwalniany.

Jawnie otwarcie obszaru roboczego domyślne lub otwarcie istniejącego obszaru roboczego w kolekcji obszarów roboczych jest opisana pod Otwórz funkcji składowej.

Sesja obszaru roboczego przez zamknięcie obszaru roboczego z Zamknij funkcji składowej.Zamknij zamyka wszystkie bazy danych nie zostało zamknięte wcześniej, wycofywanie wszelkie niezakończone transakcje.

Transakcje

DAO zarządza transakcji na poziomie obszaru roboczego; stąd transakcje z obszaru roboczego z wielu otwartych baz danych stosuje się do wszystkich baz danych.Na przykład, jeśli dwie bazy danych mają nieprzydzielonych aktualizacje i wywołania CommitTrans, wszystkie aktualizacje są zatwierdzone.Jeśli chcesz ograniczyć transakcji do pojedynczej bazy danych należy obiektu oddzielnym obszaru roboczego dla niego.

Użycie domyślnego obszaru roboczego

MFC używa obszaru roboczego domyślne dla obiektów DAO niejawnie w następujących okolicznościach:

Jeśli tworzysz nowy CDaoDatabase obiektu, ale nie za pośrednictwem istniejącego CDaoWorkspace obiektu, MFC tworzy obiekt tymczasowy obszar roboczy, odpowiadający roboczego domyślne dla obiektów DAO.Jeśli tak zrobisz dla wielu baz danych, wszystkie obiekty bazy danych skojarzonych z domyślnego obszaru roboczego.Można uzyskać dostęp do bazy danych obszaru roboczego, poprzez CDaoDatabase elementu danych.
Podobnie jeśli utworzysz CDaoRecordset obiektu bez podawania wskaźnik do CDaoDatabase obiektu, MFC tworzy obiekt tymczasowej bazy danych i przez rozszerzenie obiektu tymczasowy obszar roboczy.Możesz przejść zestaw rekordów bazy danych, a pośrednio obszaru roboczego, CDaoRecordset elementu danych.