UpdatePV サンプル:更新可能な OLE DB プロバイダーを実装します。

[アーティクル]
10/29/2009

UpdatePV サンプルは、更新可能な読み取り/書き込みプロバイダーの実装方法を示す OLE DB プロバイダーテンプレートサンプルです。具体的には、即時および遅延の挿入、更新、削除の実行方法を示します。また、一部のウィザードでのプロバイダーとの対話を簡単にするスキーマ行セットの使い方も示します。 UpdatePV では、MyProv と同様に IRowsetLocateImpl クラスも示します。

プロバイダーでのデータの読み込みと保存に関するその他の技法については、「AdvancedPV サンプル : 高度なプロバイダー技法の例」を参照してください。

セキュリティに関するメモ
このサンプルコードは概念を示すためのものであり、その概念に関連するコードのみを示しています。特定の環境について必ずしもセキュリティ要件を満たしていませんので、そのまま使用しないでください。セキュリティおよびエラー処理コードを追加して、プロジェクトをより安全かつ堅牢にすることをお勧めします。これらのサンプルコードは、現状有姿のままで提供されるものであり、一切保証されていません。

このサンプルコードは概念を示すためのものであり、その概念に関連するコードのみを示しています。特定の環境について必ずしもセキュリティ要件を満たしていませんので、そのまま使用しないでください。セキュリティおよびエラー処理コードを追加して、プロジェクトをより安全かつ堅牢にすることをお勧めします。これらのサンプルコードは、現状有姿のままで提供されるものであり、一切保証されていません。

サンプルとそのインストール手順を取得するには

Visual Studio のサンプルにアクセスするには

[ヘルプ] メニューの [サンプル] をクリックします。

既定では、これらのサンプルは drive:\Program Files\Microsoft Visual Studio 10.0\Samples\ にインストールされています。

このサンプルの最新版および他のサンプルの一覧については、MSDN Web サイト上で Visual Studio サンプル」を参照してください。

サンプルのビルドと実行

このサンプルの機能を示すには、サンプルをビルドし、プロバイダーのアクセサーを使用してコンシューマープロジェクトを作成し、データにアクセスしたり、データを出力したりするコンソールアプリケーションを作成します。

このサンプルをビルドして実行するには

ソリューションファイル UpdatePV.sln を開きます。
From the Build menu, click Build Solution.
ATL プロジェクトウィザードでコンシューマープロジェクトを作成します。このプロジェクトは属性付き .dll にします。
OLE DB コンシューマーをコンシューマープロジェクト (からクラスの追加、ATL OLE DB コンシューマーの選択 ) を追加してください。
ATL OLE DB コンシューマーウィザードで、データソースのボタンをクリックし、 でデータリンクプロパティ の UpProv OLE DB プロバイダーを選択します。 UpProv プロバイダーは UpdatePV のビルド時に自動的に登録されますが、この一覧に表示されていない場合は、UpdatePV.dll で regsvr32.exe を実行してください。
Next を移動するには、 ] タブの接続を下を使用する初期カタログを入力、MyData.txt へのパス名が正しいか確認する] をクリックします。
の OK をクリックします。データベースオブジェクトの選択ダイアログが表示される、し、 テーブル; を開く項目を 1 つだけです。MyData.txt のパス名。このアイテムを選択し、[OK] をクリックします。 ATL OLE DB コンシューマーウィザードに戻ります。
ATL OLE DB コンシューマーウィザードで、のテーブルを選択、クラスに何か短い (必要に応じて) CMyConsなど、名前を変更および完了のをクリックします。
[OK] をクリックし、ポップアップ表示されるセキュリティの警告ダイアログボックスを閉じます。
次の行を CMyCons.h から削除します。
```
#error Security Issue: The connection string may contain a password
```
この行が原因で、コンパイルできなくなります。ただし、(実際には) 機密情報を保護する必要があるという警告を表示するために挿入されています。
ソリューションエクスプローラーでプロジェクトのノードを右クリックし、[ビルド] をクリックして、コンシューマープロジェクトをビルドします。

コンソールアプリケーションを新規作成します。 .cpp ファイルで、コンシューマーヘッダーをインクルードし、コードを次のように変更します。

#include "stdafx.h"
#include <atldbcli.h>
#include "..\consumer\cmycons.h"

int _tmain(int argc, _TCHAR* argv[])
{
   HRESULT hr = CoInitialize(NULL);

   CMyCons c;

   hr = c.OpenAll();
   ATLASSERT( SUCCEEDED( hr ) );

   hr = c.MoveFirst();
   while( SUCCEEDED(hr) && hr != DB_S_ENDOFROWSET )
   {
      printf( "%d %s %s %s %s\n", c.m_Fixed, c.m_Command, c.m_Text, 
         c.m_Command2, c.m_Text2 );
      hr = c.MoveNext();
   }

   c.CloseAll();
   CoUninitialize();
   return 0;
}

CoUninitialize 関数では、ブレークポイントを設定します。これにより、コンソールの結果を表示するために開いたままになります。 [開始] をクリックして、開発環境でコンソールアプリケーションを実行します。 5 列のテキスト (インデックスが 1 列およびテキストが 4 列) が出力されます。

サンプルの動作

UpdatePV は、C ランタイムファイル入出力関数の最上位に作成されます。これはデータストアを表します。具体的には、サンプルはデータ要素のペアで構成されるテキストファイルを取得し、それを行セットに変換します。サンプルには、データ要素のペアを含む MyData.txt というテキストファイルが付属しています。ただし、サンプルは任意のテキストファイルに対して実行できます。解析の結果、すべての要素は 2 語ずつ区切られます。

UpdatePV の読み取り操作で RUpdateRowset::Execute (rowset.h) を実行します。 RUpdateRowset::FlushData で (rowset.h)、書き込み操作に処理されます。これらは、標準プロバイダー操作の一部として OLE DB プロバイダーテンプレートによって呼び出される関数です。このサンプルでは、OLE DB プロバイダーテンプレートの IRowsetChangeImpl クラスと IRowsetUpdateImpl クラスを使用します。 IRowsetChangeImpl クラスでは、即時の挿入、更新、および削除をサポートします。 IRowsetUpdateImpl クラスでは、遅延の挿入、更新、および削除をサポートします。 IRowsetUpdateImpl クラスは、IRowsetChangeImpl を継承します。データを取得/設定の詳細については、読み取りの作成、Visual C++ のドキュメントでは、更新可能なプロバイダー https://msdn.microsoft.com/ja-jp/library/1cs8bsah(v=vs.100)更新データの行セットのOLE DB プログラマで Windows SDK のドキュメントを参照するとします。

UpdatePV は、スキーマ行セットもサポートします。スキーマ行セットを使用すると、コンシューマーでは行セットを開いたりコマンドを実行したりせずに、プロバイダーの情報を検索できます。 Visual C++ ウィザードでは、スキーマ行セットを使用してクライアント側のアクセサーを生成します。主な機能は、CUpdateSessionTRSchemaRowset::ExecuteCUpdateSessionColSchemaRowset::ExecuteCUpdateSessionPTSchemaRowset::Execute です。 3 つの関数はすべて、プロバイダーがサポートするテーブル、テーブルの列、およびテーブルのデータ型に関する情報を返します。スキーマ行セットの詳細については、IDBSchemaRowset OLE DB プログラマリファレンスインターフェイス」を参照してください。

Keywords

このサンプルでは次のインターフェイスを使用します。

IRowsetChange, IRowsetUpdateImpl

このサンプルでは、次のプロパティを使用します。

DBPROP_IRowsetChange , DBPROP_IRowsetUpdate

参照

その他の技術情報

ATL サンプル

次の方法で共有