OLE DB コンシューマー テンプレート リファレンス

OLE DB コンシューマー テンプレートは、以下のクラスを含んでいます。 「OLE DB テンプレート リファレンス」には「OLE DB コンシューマー テンプレート用マクロおよびグローバル関数」のトピックもあります。

セッション クラス

• CDataConnection
  データ ソースに対する接続を管理します。 このクラスは、クライアントの作成に有効であり、データ ソースに対する接続時に必要なオブジェクト (データ ソースおよびセッション) と必要な一部の操作をカプセル化します。

• CDataSource
  OLE DB データ ソース オブジェクトに相当します。このオブジェクトは、プロバイダーを経由したデータ ソースとの接続を表します。 1 つの接続に対して、各 CSession オブジェクトで表される 1 つ以上のデータベース セッションを作成できます。

• CEnumerator
  OLE DB 列挙子オブジェクトに相当します。このオブジェクトは、使用可能なデータ ソースの行セット情報を取得します。

• CEnumeratorAccessor
  CEnumerator はこのクラスを使用して、列挙子行セットのデータにアクセスします。 この行セットは、現在の列挙子から参照できるデータ ソースと列挙子で構成されます。

• CSession
  1 つのデータベース アクセス セッションを表します。 1 つ以上のセッションをそれぞれ CDataSource オブジェクトに関連付けることができます。

アクセサー クラス

• CAccessor
  データ ソースと静的に連結されたレコードに使用します。 このアクセサー クラスは、データベースの構造がわかっている場合に使用します。

• CAccessorBase
  すべてのアクセサー クラスの基本クラスです。

• CDynamicAccessor
  行セットの列情報に基づいて実行時に作成されるアクセサーです。 データ ソースの構造が不明な場合は、このクラスを使用してデータを取得します。

• CDynamicParameterAccessor
  コマンドの情報が不明な場合に使用できるアクセサーです。 プロバイダーが ICommandWithParameters インターフェイスをサポートする場合は、そのインターフェイスを呼び出してパラメーター情報を取得します。

• CDynamicStringAccessor
  データベースの基になる構造に関する情報が不明な場合にもデータ ソースにアクセスできます。

• CDynamicStringAccessorA
  データ ストアから取得するデータを ANSI 文字列データとして要求することを除いて、CDynamicStringAccessor と同様です。

• CDynamicStringAccessorW
  データ ストアから取得するデータを UNICODE 文字列データとして要求することを除いて、CDynamicStringAccessor と同様です。

• CManualAccessor
  列とコマンド パラメーターの両方を処理するメソッドを持つアクセサーです。 このクラスを使用すると、プロバイダーが型変換可能なデータ型の場合、どのデータ型でも使用できます。

• CNoAccessor
  クラスでパラメーターまたは出力列をサポートしない場合は、テンプレート引数として使用できます。

• CXMLAccessor
  データ ストアから取得するすべてのデータを XML 形式のタグ付きのデータとして変換することを除いて、CDynamicStringAccessor と同様です。

行セット クラス

• CAccessorRowset
  1 つの行セットとそれに関連するアクセサーを 1 つのクラスにカプセル化します。

• CArrayRowset
  配列構文を使用して行セットの要素にアクセスする場合に使用します。

• CBulkRowset
  1 回の呼び出しで複数の行ハンドルを取得することによって、複数行をフェッチして操作します。

• CNoRowset
  コマンドが行セットを返さない場合に、テンプレート引数として使用できます。

• CRestrictions
  スキーマ行セットに対する制限の指定に使用します。

• CRowset
  行セット データの操作、設定、および取得に使用します。

• CStreamRowset
  行セットの代わりに ISequentialStream オブジェクトを返します。Read メソッドを使用してデータを XML 形式で取得します。 SQL Server 2000 では書式を指定します。したがって、この機能は SQL Server 2000 でだけ動作します。

• IRowsetNotifyImpl
  IRowsetNotify のダミーの実装を提供します。IRowsetNotify のメソッド OnFieldChange、OnRowChange、および OnRowsetChange に対する関数は空です。

スキーマ行セット クラスと Typedef クラス

OLE DB テンプレートは、OLE DB スキーマ行セットに相当するクラスを提供します。

コマンド クラス

• CCommand
  パラメーター ベースの OLE DB コマンドを設定して実行する場合に使用します。 単純な行セットを開くだけの場合は、代わりに CTable を使用します。

• CMultipleResults
  コマンドが複数の結果セットを処理するように設定する場合に、CCommand テンプレートのテンプレート引数として使用します。

• CNoAccessor
  アクセサー クラス引数を必要とする CCommand や CTable などのテンプレート クラスのテンプレート引数として使用します。 パラメーターまたは出力列をサポートしないようにクラスを設定する場合に、CNoAccessor を使用します。

• CNoMultipleResults
  コマンドが 1 つの行セットを処理するように設定する場合に、CCommand テンプレートのテンプレート引数として使用します。 CNoMultipleResults は、テンプレート引数の既定値です。

• CNoRowset
  コマンドやテーブルが行セットを返さない場合に、CCommand または CTable のテンプレート引数として使用します。

• CTable
  パラメーターなしの単純な行セットにアクセスする場合に使用します。

プロパティ クラス

• CDBPropIDSet
  コンシューマーがプロパティ情報を取得するプロパティ ID の配列を渡す場合に使用します。 プロパティは 1 つのプロパティ セットに所属します。

• CDBPropSet
  プロバイダーのプロパティを設定する場合に使用します。

ブックマーク クラス

• CBookmark
  行セットのデータにアクセスするためのインデックスとして使用します。

エラー クラス

• CDBErrorInfo
  OLE DB エラー情報を取得する場合に使用します。

参照

概念

OLE DB プロバイダー テンプレート リファレンス

その他の技術情報

OLE DB テンプレート