CDaoWorkspace クラス

[アーティクル]
02/21/2013

シングルユーザーによる名前付きの、パスワードで保護されたデータベースセッションのログインからログオフまでを管理します。

class CDaoWorkspace : public CObject

メンバー

パブリックコンストラクター

名前	説明
CDaoWorkspace::CDaoWorkspace	ワークスペースオブジェクトを構築します。その後、呼び出し [作成] か [開く]。

パブリックメソッド

名前	説明
CDaoWorkspace::Append	データベースエンジンのワークスペースのコレクションに新しく作成されたワークスペースを追加します。
CDaoWorkspace::BeginTrans	ワークスペースで開いているすべてのデータベースに適用する新しいトランザクションを開始します。
CDaoWorkspace::Close	ワークスペースと含むオブジェクトをすべて閉じます。保留中のトランザクション転がされます。
CDaoWorkspace::CommitTrans	現在のトランザクションが終了し、変更内容を保存します。
CDaoWorkspace::CompactDatabase	(または) 複製データベースを最適化します。
CDaoWorkspace::Create	新しい DAO のワークスペースオブジェクトを作成します。
CDaoWorkspace::GetDatabaseCount	ワークスペースのデータベースのコレクションの DAO データベースオブジェクトの数を返します。
CDaoWorkspace::GetDatabaseInfo	ワークスペースのデータベースのコレクションで定義される指定した DAO データベースに関する情報を返します。
CDaoWorkspace::GetIniPath	Windows レジストリの Microsoft Jet データベースエンジンの初期化の設定の場所を返します。
CDaoWorkspace::GetIsolateODBCTrans	データソースへの強制変換、複数のコネクションから独立している同一の ODBC データソースを含む複数のトランザクションかどうかを示す値を返します。
CDaoWorkspace::GetLoginTimeout	ユーザーが ODBC データベースにログインしようとしたときにエラーが発生するまでの秒数を返します。
CDaoWorkspace::GetName	ワークスペースオブジェクトのユーザー定義の名前を返します。
CDaoWorkspace::GetUserName	ワークスペースが作成されたときに指定されたユーザー名を返します。これは、ワークスペースの所有者の名前です。
CDaoWorkspace::GetVersion	ワークスペースに関連付けられているデータベースエンジンのバージョンを含む文字列を返します。
CDaoWorkspace::GetWorkspaceCount	データベースエンジンのワークスペースのコレクションの DAO のワークスペースのオブジェクトの数を返します。
CDaoWorkspace::GetWorkspaceInfo	データベースエンジンのワークスペースのコレクションで定義される指定した DAO のワークスペースに関する情報を返します。
CDaoWorkspace::Idle	データベースエンジンでバックグラウンドタスクを実行するようにします。
CDaoWorkspace::IsOpen	ワークスペースが開いている場合は、を返します。
CDaoWorkspace::Open	明示的に DAO の既定のワークスペースに関連付けられているワークスペースオブジェクトを開きます。
CDaoWorkspace::RepairDatabase	損なわれたデータベースを修復します。
CDaoWorkspace::Rollback	現在のトランザクションが終了し、変更を保存しません。
CDaoWorkspace::SetDefaultPassword	ワークスペースのオブジェクトが特定のパスワードを指定せずに作成されるとデータベースエンジンで使用するパスワードを設定します。
CDaoWorkspace::SetDefaultUser	ワークスペースのオブジェクトが特定のユーザー名を指定せずに作成されるとデータベースエンジンで使用するユーザー名を設定します。
CDaoWorkspace::SetIniPath	Windows レジストリの Microsoft Jet データベースエンジンの初期化の設定の場所を設定します。
CDaoWorkspace::SetIsolateODBCTrans	同じ ODBC データソースを含む複数のトランザクションがようにデータソースに対して複数の接続の強制変換によって分離するかを指定します。
CDaoWorkspace::SetLoginTimeout	ユーザーが ODBC データソースにログインしようとしたときにエラーが発生するまでの秒数を設定します。

パブリックデータメンバー

名前	説明
CDaoWorkspace::m_pDAOWorkspace	基になる DAO のワークスペースオブジェクトへのポインター。

解説

ほとんどの場合、複数のワークスペースを必要とせず、明示的なワークスペースオブジェクトを作成する必要はありません; データベースとレコードセットオブジェクトを開くと、DAO の既定のワークスペースを使用します。ただし、必要に応じて、追加のワークスペースのオブジェクトを作成することによって、複数のセッションを同時に実行できます。各ワークスペースオブジェクトは独自のデータベースのコレクションで複数の開いているデータベースオブジェクトを含めることができます。MFC では、ワークスペースは同じです「トランザクション空間における開いているデータベースを指定する主にトランザクションマネージャー」。

[!メモ]

DAO データベースクラスは、ODBC (Open Database Connectivity) に基づく MFC データベースクラスとは異なります。すべての DAO データベースクラス名に「CDao」が付きます。一般に、に基づく MFC DAO クラスは、ODBC に基づいて MFC クラスよりもできます。DAO ベースのクラスは、ODBC ドライバーなどの Microsoft Jet データベースエンジンを使用してデータにアクセスします。これらは、クラスによって DAO を直接呼び出さないでデータベースの作成、テーブル、およびフィールドの追加など、データ定義言語の (DDL)、操作をサポートします。

Capabilities

クラスは、次 CDaoWorkspace が用意されています:

明示的なアクセス、必要に応じて、データベースエンジンの初期化で作成された既定のワークスペースへ。通常使用 DAO の既定のワークスペース暗黙的にデータベースとレコードセットオブジェクトを作成する。
トランザクションがワークスペースで開いているすべてのデータベースに適用するトランザクションの領域。他のトランザクションの空間を管理するために追加のワークスペースを作成できます。
基になる Microsoft Jet データベースエンジンの多くのプロパティへのインターフェイス (静的メンバー関数を参照)。開くか作成する前に、ワークスペースまたは静的メンバー関数を呼び出してレコードを開くか作成して、データベースエンジンを初期化します。
そのパスに追加されるすべてのアクティブなワークスペースを格納するデータベースエンジンのワークスペースのコレクションへのアクセス。また、ワークスペースをコレクションに追加せずに作成して使用できます。

セキュリティ

MFC では、ユーザーを実装せず、機密管理に使用する DAO のコレクションをグループ化されません。DAO の側面を必要とする場合は、独自の DAO インターフェイスに直接呼び出しによってプログラムする必要があります。ついては、テクニカルノート 54を参照してください。

使用方法

クラス CDaoWorkspace を使用する:

明示的に既定のワークスペースを開きます。

通常、既定のワークスペースを使用すると、— CDaoDatabase または CDaoRecordset の新しいオブジェクトを開くと暗黙的です。しかし、たとえば) を明示的にアクセスし、データベースエンジンのプロパティまたはワークスペースのコレクションにアクセスする必要がある場合があります。「既定のワークスペースの暗黙の使用」を参照してください。
新しいワークスペースを作成します。ワークスペースのコレクションに追加する場合は、[追加] を呼び出します。
ワークスペースのコレクションの既存のワークスペースを開きます。

ワークスペースのコレクションにない新しいワークスペースを作成することは [作成] のメンバー関数の下で説明します。ワークスペースオブジェクトは datababase エンジンのセッションの間に任意の方法で保持されません。アプリケーションのリンクの MFC と静的に、アプリケーションを終了データベースエンジンを uninitializes。MFC DLL がアンロードされたときの MFC アプリケーションのリンクが動的に、データベースエンジン初期化されていない場合は。

明示的に既定のワークスペースを開くか、ワークスペースコレクションの既存のワークスペースを開くには [開く] のメンバー関数では、示します。

[閉じる] のメンバー関数のワークスペースを閉じることで、ワークスペースのセッションを終了します。[閉じる] は、以前に閉じていないデータベースを閉しました、変更されていないトランザクションをロールバックされます。

トランザクション

DAO はワークスペースのレベルでトランザクションを管理します; したがって、複数の開いているデータベースを使用して、ワークスペースのトランザクションは、データベースすべてに適用されます。たとえば、2 種類のデータベースに対するいない更新プログラムがあり、CommitTransを呼び出すと、更新はすべてコミットされます。一つのデータベースにトランザクションを制限する場合は、の別のワークスペースのオブジェクトが必要です。

既定のワークスペースの暗黙の使用

MFC の DAO 使用の既定のワークスペース暗黙的に次の場合:

CDaoDatabase の新しいオブジェクトを作成しますが、CDaoWorkspace の既存のオブジェクトを使用しない場合は、MFC DAO の既定のワークスペースに対応する一時的なワークスペースオブジェクトを作成します。複数のデータベースに対してすると、データベースオブジェクトはすべて、既定のワークスペースに関連付けられます。CDaoDatabase のデータメンバーを通じてデータベースのワークスペースにアクセスできます。
同様に CDaoDatabase オブジェクトへのポインターを指定せず CDaoRecordset のオブジェクトを作成する場合、MFC は、拡張子によって、一時データベースオブジェクトとワークスペースの一時的なオブジェクトを作成します。CDaoRecordset のデータメンバーを通じてレコードセットのデータベースや間接的にワークスペースにアクセスできます。

他の操作

他のデータベース操作は、破損したデータベースを修復またはデータベースを最適化することなど、に用意されます。

DAO を直接呼び出すことと DAO のセキュリティについては、テクニカルノート 54を参照してください。

継承階層

CObject

CDaoWorkspace

必要条件

Header: afxdao.h

次の方法で共有

CDaoWorkspace クラス

メンバー

パブリックコンストラクター

パブリックメソッド

パブリックデータメンバー

解説

Capabilities

セキュリティ

使用方法

トランザクション

既定のワークスペースの暗黙の使用

他の操作

継承階層

必要条件

参照

関連項目

その他のリソース

次の方法で共有

CDaoWorkspace クラス

メンバー

パブリック コンストラクター

パブリック メソッド

パブリック データ メンバー

解説

Capabilities

セキュリティ

使用方法

トランザクション

既定のワークスペースの暗黙の使用

他の操作

継承階層

必要条件

参照

関連項目

その他のリソース

パブリックコンストラクター

パブリックメソッド

パブリックデータメンバー