この章では、以下の項目について説明します。

このセクションには、PSQL OLE DB プロバイダーを Visual Basic 開発環境に組み込むのに役立つ情報が含まれています。

この手順は、ビジュアル コントロール オブジェクトを使用しない ADO と OLE DB でのプログラミングの方法を示しています。

PSQL プロバイダーには初期化に必須のプロパティが 1 つあります。それは、DataSource プロパティです。OLE DB プロバイダーは DSN を使用しないので、DataSource プロパティにはデータベース名の値を設定する必要があります。たとえば、ADO の Connection::Open コマンドの接続文字列は、「Provider=PervasiveOLEDB;Data Source=<data store>」になります。この <data store> にはデータベース名を指定します。

接続を作成するには、CursorLocation を設定し、ConnectionString を設定して Open を呼び出すか、または Open 呼び出しで接続文字列を指定します。

または

PSQL Control Center で名前付きデータベースを作成することができます。

Control Center のエクスプローラー内で、データベースを作成するデータベース エンジンを右クリックし、［新規作成｜データベース］を選択します。これは、アプリケーションを中断することなく必要に応じてデータを移動できるので、データ ストアを指定する好ましい方法です。アプリケーションから新しいディレクトリを指すために必要なのは、サーバーで名前付きデータベースのパス変更することだけです。それぞれのクライアント コンピューターで再設定を行うのではなく、1 つの簡単な作業で済みます。

アプリケーションにパスをハード コーディングすることはお勧めしません。しかし、アプリケーションでレジストリ エントリまたは環境変数からパスを取得することができ、次のような文字列を作成できる場合は、パスを使用することで、名前付きデータベースを定義することなくデータ ストアに簡単にアクセスすることができます。

アプリケーションでパスをハード コーディングするのではなく、接続文字列内で Location パラメーターを使用してリモート データベースに接続することができます。

接続を作成し、その接続を使用して複数のレコードセットを作成することができます。これは、各レコードセットに個別の接続を作成するよりも効率的です。

レコードセットを一度開くと、Move x、MoveFirst、MoveNext、MovePrevious および MoveLast を使用してデータ間を移動することができます。Move メソッドでは 1 つのパラメーターが必要です。このパラメーターは移動するレコード数を指します。負の数を指定すると、カーソルはレコードセットの後方に（最初のレコードに向かって）移動します。

新しいレコードを追加するには、AddNew メソッドを使用します。パラメーターは必要ありませんが、呼び出しの中でフィールドと値を指定することができます。カーソルは新たに追加されるレコードを指すので、移動することなく、直ちにそのフィールドへの更新を行うことができます。

即時更新モードでは、空のレコードがデータ ストアに書き込まれ、フィールドへの更新がそのまま保存されます。バッチ更新モードでは、空のレコードを作成しますが、そのレコードは Update または UpdateBatch が呼び出されるまで書き込まれません。

または

レコードを削除するには、Delete メソッドを使用します。オプション パラメーターが 1 つあります。このパラメーターは削除するレコードを指します。現在、PSQL プロバイダーでサポートするのはデフォルトの adAffectCurrent のみです。

レコードを更新するには、適切なフィールドに、希望する値を割り当てた後で Update または UpdateBatch を呼び出します。

レコードの検索に使用するメソッドは、レコードセットの設定によって異なります。動的なレコードセットの場合、PSQL では Index プロパティと Seek メソッドをサポートします。

Sort メソッドと Find メソッド（静的なクライアント側のカーソルでのみ動作）は OLE DB プロバイダーで提供されていますが、現在はサポートされておらず、これらを使用しないことを推奨しています。すべての検索およびソートにおいて、Index メソッドと Seek メソッドの方が信頼性が高く、PSQL エンジンを直接使用します。これにより、クライアント側のレイヤーの使用に際してパフォーマンスが向上します。

Seek メソッドでは、検索する値を含むバリアント配列が必要です。1 つまたは複数の列で構成されるインデックスおよびその値を含む配列を、それぞれ対応する列で比較します。このため、セグメント インデックスがある場合、現在のインデックスに含まれるセグメント数と等しい要素数でバリアント配列を宣言する必要があります。

ADO のデフォルトのロック タイプは読み取り専用です。このロック タイプの変更は、レコードセットの Open 呼び出しでロック タイプ パラメーターを指定し、レコードセットにその変更を書き込むのに使用するメソッドを適用することによって変更できます。

レコードセットを更新するには、即時更新モード、単一行バッチ更新モード、または複数行バッチ更新モードのいずれかを使用するためにロック タイプを変更します。

Pervasive.SQL V8 より前の OLE DB プロバイダーではロック タイプに adLockPessimistic をサポートしていませんでした。ロック タイプを指定しない場合、Update メソッドは必要なく、更新はフィールド単位でデータ ストアに書き込まれます。この方法は効率が悪いので、その他のロック タイプが特定のアプリケーションで受け入れられないことが判明している場合以外は使用しないでください。

バッチ更新モードには、単一行と複数行があります。

ロック タイプに adLockOptimistic を使用した場合、変更の書き込みには Update メソッドを使用し、一度に 1 つのレコードを処理するコードを記述する必要があります。ADO をレコードセット内のほかの行で動作させるオペレーション、または現在行をリフレッシュさせるオペレーションはいずれも、ADO の暗黙的な Update 呼び出しをトリガーします。ただし、これは即時更新モードよりも非常に効率的です。以下に、即時更新モードを使用してレコードセットを開く例を示します。

ロック タイプに adLockBatchOptimistic を使用した場合、変更の書き込みには UpdateBatch メソッド を使用し、一度に複数レコードの変更処理を行うコードを記述することができます。

これはパフォーマンスの点から見れば最良のロック タイプですが、アプリケーション設計で ADO が一度に複数行をキャッシュして更新できるようにする必要があります。このロック タイプが必ずしも、マルチユーザー、スループットの大きいアプリケーションに適しているとは限りません。以下に、バッチ更新モードを使用してレコードセットを開く例を示します。

ADO ではオブジェクトを使ってデータにアクセスし、そのデータをユーザーに提供します。Microsoft ADO Data Control を使用している場合は、接続とレコードセット オブジェクトのインスタンスを作成する必要はありません。ただし、接続とレコードセットの作成と破棄を直ちに行うようにする場合は、インスタンスを作成してから、後でオブジェクトを破棄する必要があります。さらに、現在出荷されているバージョンの ADO Data Control では、コードからレコードセットを作成し、コード内でこのレコードセットに ADO Data Control の Recordset プロパティを設定する場合にのみ ADO 2.1 の機能（インデックス サポートなど）を使用します（また、これはデフォルトの ADO 2.0 ではなく、ADO 2.1 を含めるプロジェクト参照の変更も必要です）。

オブジェクトのインスタンスを作成する場合は、New キーワードを使用します。オブジェクトの宣言で次のように記述します。

使用する直前で次のように記述します。

これらのオブジェクトを破棄するには、次のように記述します。

ADO で使用するブックマークは、文書の中で使用する通常のブックマークと同じで、後でその場所を見つけることができます。これは、データベース内を検索する場合、または複数のテーブルを使用する場合には特に便利です。バリアント変数を使用してブックマークを保存します。

メモ：ADO イベントを使用する際は、1 つのイベントでほかのイベントを生成する呼び出しを行わないよう十分に注意する必要があります。これは、無限ループに陥る可能性が高くなるからです。無限ループが発生する例をより具体的に挙げると、MoveComplete イベントの代わりに、WillMove イベントを使用してファイルの最後（EOF）条件を処理する場合です。

このコードでは、無限ループに陥り、その結果メモリがいっぱいになってスタック領域が不足するエラーが発生します。このエラーを回避するには、Adodc1_MoveComplete イベントを使用する必要があります。

レコードセット内のフィールドに値を割り当てる場合は、レコードセット名、感嘆符（!）およびフィールドを参照するフィールド名によって指定することができます。フィールドは番号で参照することもできます。

また、Field オブジェクトのほかのプロパティを使って、フィールドに格納されているデータの詳細情報を調べることもできます。たとえば、ActualSize ではフィールド内のデータの長さを、OriginalValue ではレコードセットのこのインスタンスで行った変更前の元の値を、そして Type ではデータ型を知ることができます（あるフィールドの値と別のフィールドの値またはメモリ内の値とを比較する方法を調べる場合に便利です）。

トランザクションは、Connection オブジェクトを使って ADO 内に実装されています。トランザクション用に使用できるメソッドは次のとおりです。

これらのメソッドにはパラメーターがありません。