読み取り専用プロバイダのテスト

更新 : 2007 年 11 月

プロバイダをテストするにはコンシューマが必要です。これには、プロバイダに対応する機能がコンシューマでサポートされている必要があります。OLE DB コンシューマテンプレートは、OLE DB を取り囲む薄いラップであり、プロバイダの COM オブジェクトに相当します。ソースはコンシューマテンプレートに付属しているため、これを使用してプロバイダを簡単にデバッグできます。また、コンシューマテンプレートを使うと、コンシューマアプリケーションを少ないコードで短時間に開発できます。

このトピックの例では、MFC アプリケーションウィザードのテストコンシューマ用の既定のアプリケーションを作成します。テストアプリケーションは、OLE DB コンシューマテンプレートコードが追加された単純なダイアログです。

テストアプリケーションを作成するには

[ファイル] メニューの [新規作成] をポイントし、[プロジェクト] をクリックします。
[プロジェクトの種類] ペインで、[Visual C++ プロジェクト] フォルダを選択します。テンプレートペインの [MFC アプリケーション] をクリックします。
プロジェクト名に「TestProv」と入力し、[OK] をクリックします。

MFC アプリケーションウィザードが表示されます。
[アプリケーションの種類] ページの [ダイアログベース] を選択します。
[高度な機能] ページの [オートメーション] を選択し、[完了] をクリックします。

メモ :
CTestProvApp::InitInstance に CoInitialize を追加した場合、アプリケーションはオートメーションサポートを必要としません。

[TestProv] ダイアログボックス (IDD_TESTPROV_DIALOG) は、リソースビューで選択して、表示したり編集したりできます。行セットの各文字列用に 1 つずつ、合計 2 つのリストボックスをダイアログボックスに配置します。リストボックスが選択されているときに Alt キーを押しながら Enter キーを押し、[スタイル] タブをクリックして [並べ替え] チェックボックスをオフにすることにより、両方のリストボックスの並べ替えプロパティをオフにします。また、ダイアログボックスには、ファイルをフェッチする [Run] ボタンを配置します。完成した [TestProv] ダイアログボックスには、"String 1" および "String 2" というラベルの付いた 2 つのリストボックスが作成されます。また、[OK]、[キャンセル]、および [Run] の各ボタンもあります。

ダイアログクラスのヘッダーファイル (この場合は TestProvDlg.h) を開きます。ヘッダーファイルで、クラス宣言の外側に次のコードを追加します。

////////////////////////////////////////////////////////////////////////
// TestProvDlg.h

class CProvider 
{
// Attributes
public:
   char   szField1[16];
   char   szField2[16];

   // Binding Maps
BEGIN_COLUMN_MAP(CProvider)
   COLUMN_ENTRY(1, szField1)
   COLUMN_ENTRY(2, szField2)
END_COLUMN_MAP()
};

このコードは、どの列が行セットに入るかを定義するユーザーレコードを表します。クライアントは、IAccessor::CreateAccessor を呼び出すときにこれらのエントリを使用して連結する列を指定します。OLE DB コンシューマテンプレートを使用して、列を動的に連結することもできます。COLUMN_ENTRY マクロは、プロバイダの PROVIDER_COLUMN_ENTRY マクロに相当するクライアント側のマクロです。2 つの COLUMN_ENTRY マクロは、2 つの文字列の序数、型、長さ、およびデータメンバを指定します。

Ctrl キーを押しながら [Run] ボタンをダブルクリックすることにより、[Run] ボタンのハンドラ関数を追加します。関数に次のコードを配置します。

///////////////////////////////////////////////////////////////////////
// TestProvDlg.cpp

void CtestProvDlg::OnRun()
{
   CCommand<CAccessor<CProvider> > table;
   CDataSource source;
   CSession   session;

   if (source.Open("MyProvider.MyProvider.1", NULL) != S_OK)
      return;

   if (session.Open(source) != S_OK)
      return;

   if (table.Open(session, _T("c:\\samples\\myprov\\myData.txt")) != S_OK)
      return;

   while (table.MoveNext() == S_OK)
   {
      m_ctlString1.AddString(table.szField1);
      m_ctlString2.AddString(table.szField2);
   }
}

CCommand、CDataSource、CSession の各クラスは、すべて OLE DB コンシューマテンプレートに属します。各クラスは、プロバイダの COM オブジェクトと同じ動作をします。CCommand オブジェクトは、ヘッダーファイルで宣言された CProvider クラスをテンプレートパラメータとして使用します。CProvider パラメータは、プロバイダからデータにアクセスするために使用するバインディングを表します。次に、データソース、セッション、およびコマンドの Open コードを示します。

   if (source.Open("MyProvider.MyProvider.1", NULL) != S_OK)
      return;

   if (session.Open(source) != S_OK)
      return;

   if (table.Open(session, _T("c:\\samples\\myprov\\myData.txt")) != S_OK)
      return;

上記の各クラスを開くコードでは、それぞれのクラスに対応する COM オブジェクトがプロバイダに作成されます。プロバイダを特定するには、プロバイダの ProgID を使用します。ProgID は、システムレジストリから取得するか、MyProvider.rgs ファイルを検索 (プロバイダのディレクトリを開き、ProgID キーを検索) することで取得できます。

MyData.txt ファイルは、MyProv サンプルに含まれています。独自のファイルを作成するには、エディタを使用して偶数個の文字を入力し、各文字間で Enter キーを押します。ファイルを移動した場合はパス名を変更してください。

table.Open 行で "c:\\samples\\myprov\\MyData.txt" という文字列を渡します。Open 呼び出しにステップインすると、この文字列がプロバイダの SetCommandText メソッドに渡されることがわかります。これは、ICommandText::Execute メソッドが使用した文字列です。

データをフェッチするには、テーブルに対して MoveNext を呼び出します。MoveNext は、IRowset::GetNextRows、GetRowCount、および GetData の各関数を呼び出します。それ以上行がない場合 (つまり、行セットの現在位置が GetRowCount を超えた場合) は、ループが終了します。

   while (table.MoveNext() == S_OK)
   {
      m_ctlString1.AddString(table.szField1);
      m_ctlString2.AddString(table.szField2);
   }

それ以上行がない場合、プロバイダは DB_S_ENDOFROWSET を返します。DB_S_ENDOFROWSET 値はエラーではありません。S_OK が返されなかった場合は、データフェッチのループを終了するようにしてください。行の有無の判断に SUCCEEDED マクロは使用しないでください。

これで、プログラムをビルドしてテストできるようになります。

参照

単純な読み取り専用プロバイダの機能の拡張

Last updated on 2008-09-17

読み取り専用プロバイダのテスト

テスト アプリケーションを作成するには

参照

参照

その他のリソース

テストアプリケーションを作成するには