ActiveX クイックスタート

このページをシェアする

ActiveX クイックスタート

以下のトピックでは、ActiveX アクセス方法に付属するファイルの PSQL ディレクトリ構造を示すほか、コントロールを使用するアプリケーションの開発に関わる基本的作業手順について説明します。

•ActiveX で使用されるファイルとディレクトリ

•ActiveX アクセス方法を使用したアプリケーションの作成

（主な作業のリストについては、上記のトピックを参照してください）

•PSQL ActiveX ファイルの配布と登録

•ActiveX アクセス方法に関する追加情報

ActiveX で使用されるファイルとディレクトリ

ActiveX アクセス方法のファイルとディレクトリを表 2 に示します。この表では、PSQL がデフォルトの場所にインストールされていることを前提としています。PSQL ファイルのデフォルトの保存場所については、『Getting Started with PSQL』の PSQL ファイルはどこにインストールされますか？を参照してください。

アプリケーションの実装に必要なファイルについては、PSQL ActiveX ファイルの配布と登録を参照してください。

表 2 ActiveX アクセス方法ファイル
ファイル	場所	説明
ACBTR732.OCX	<file_path>\PSQL\bin\	PSQL データソースコントロール
ACCTR732.OCX	<file_path>\PSQL\bin\	PSQL バウンドコントロール
.DDF、.MKD	ProgramData\Actian\PSQL\Demodata\	データ辞書ファイル（.DDF）と MicroKernel エンジンのテーブル（.MKD ファイル）
readme_activex.htm	<file_path>\PSQL\Docs	リリースノート情報
PSQL.JAR	<file_path>\PSQL\bin\	PSQL Java アクセスライブラリ用 JAR ファイル

ActiveX アクセス方法を使用したアプリケーションの作成

ここでは、ActiveX アクセス方法を使用したアプリケーションの作成に関連する主な作業を行う方法について説明します。作業項目は以下のとおりです。

•プロジェクトへの ActiveX アクセス方法の追加

•データソースへのバウンドコントロールのリンク

•Extended オペレーションの有効化

プロジェクトへの ActiveX アクセス方法の追加

►ActiveX アクセス方法のデータソースとバウンドコントロールを Visual Basic プロジェクトに追加するには

1 ［プロジェクト］メニューから［コンポーネント］を選択するか、またはツールボックスを右クリックして［コンポーネント］を選択します。

2 コントロールリストをスクロールさせて、"PSQL ActiveX Data Source" および "PSQL Bound Controls" チェックボックスをオンにします。

3 ［OK］をクリックします。

ツールボックスに青色の PSQL ActiveX アイコンが表示されます。

VAccess コントロールの使用

VAccess コントロールはデータをポイントするもので、ほかすべての PSQL コントロールがバインドするマスターコントロールです。このコントロールは、PSQL とのすべての通信を処理します。

►Visual Basic フォームにデータソースコントロールを追加するには

1 PSQL ActiveX コントロールを含んでいる Visual Basic のツールボックスをクリックします。

2 VAccess コントロールアイコンをクリックします。

3 フォームにカーソルを置いてドラッグし、コントロールを保持するための四角形を作成します。マウスを離すと、四角形の中に ActiveX アクセス方法が表示されます。このコントロールは、設計時にはアイコンとして表示されますが、実行時には表示されません。

また、PSQL の起動画面には、PSQL ワークステーションエンジンが起動されたことが表示されます。

4 デフォルトでは、フォームに配置する最初の VAccess コントロールには VAccess1 という名前が付きます。必要であれば、Name プロパティに新しい名前を入力してこの名前を変更できます。

次に、この VAccess コントロールのプロパティを設定する必要があります。プロパティへのアクセス、プロパティの設定、および PSQL ファイルへの接続をお読みください。

プロパティへのアクセス

コントロールのプロパティは次の 3 つの場所で設定できます。

•プロパティページダイアログボックス

•Visual Basic のプロパティウィンドウ

•Visual Basic コードエディター

プロパティページ

コントロールを右クリックし、ショートカットメニューから［プロパティ］を選択すると、プロパティページが表示されます。これは、コントロールの PSQL ActiveX プロパティを設定できるタブ付きのダイアログボックスです。詳細については、図 2 を参照してください。

図 2 プロパティページダイアログボックス

Visual Basic のプロパティウィンドウ

Visual Basic のプロパティウィンドウには、Visual Basic に固有のプロパティなど、選択したオブジェクトのすべてのプロパティセットが表示されます。

図 3 VAccess プロパティを表示するプロパティウィンドウ

Visual Basic コードエディター

フォームまたはコントロールをダブルクリックすると、Visual Basic のコードエディターが開きます。コードエディターの使用方法については、Visual Basic のマニュアルを参照してください。各プロパティの構文などの詳細については、本マニュアルを参照してください。

プロパティの設定

►コントロールのプロパティを設定するには

1 プロパティを設定するコントロールを選択します。

2 プロパティページ、Visual Basic プロパティウィンドウまたはコードエディターで変更するプロパティを検索します。プロパティへのアクセスについては、プロパティへのアクセスを参照してください。

3 追加または変更する各プロパティの値を設定するには、テキストボックスにその値を入力するか、フィールドをクリックしたときに表示されるドロップダウンリストから値を選択するか、あるいは、値の設定が行えるダイアログボックスを呼び出す省略記号をクリックします。

メモ：プロパティには、設計時または実行時に設定できるものと、設計時または実行時にしか設定できないものがあります。

PSQL ファイルへの接続

VAccess コントロールには、このコントロールを PSQL データファイルへ接続するための重要なプロパティとして、DdfPath、TableName、および Location という 3 つのプロパティがあります。これらのプロパティにアクセスする最も簡単な方法は、コントロールを右クリックしてショートカットメニューから［プロパティ］を選択したときに表示されるプロパティページからアクセスする方法です。プロパティウィンドウからも、これらのプロパティにアクセスできます。

図 4 データに接続するためのプロパティの設定

データに接続するための 3 つの重要なプロパティを以下に示します。

•DdfPath – このプロパティは、VAccess コントロールで使用する DDF（データ辞書ファイル）の位置を決定します。プロパティには、DDF が置かれている有効なドライブとパスが含まれていなければなりません。

•TableName – このプロパティは、DDF のどのテーブル（データファイル）が VAccess コントロールで使用されるかを決定します。DdfPath で指定された DDF に含まれている有効なテーブル名に設定する必要があります。ドロップダウンメニューからテーブル名を選択できます。

•Location – このプロパティは、どの PSQL テーブルが VAccess コントロールで使用されるかを決定します。FILE.DDF に含まれる Table Location に対応しています。デフォルトでは、TableName プロパティで指定されたテーブルの Table Location になりますが、必要に応じてテーブルへの代替パスを指定することもできます。

►データを指定するプロパティを設定するには

1 データに接続する VAccess コントロールを選択します。

2 VAccess コントロールの DdfPath を設定します。

3 TableName プロパティのドロップダウンメニューからテーブル名を選択します。このメニューには、手順 2 で指定した DDF で使用できるテーブル名が含まれています。

この VAccess コントロールにバインドするバウンドコントロールはすべて、このテーブルを参照します。

4 手順 3 でテーブル名を選択すると、Location プロパティはそのテーブルを含んでいる .mkd ファイルに変更されます。

データへの接続を完了するには、IndexNumber プロパティをアクセスしたいインデックスに設定します。

メモ：実行時にコードからこれらのプロパティを設定しても、同じ順序が適用されます。

インデックスの選択

VAccess コントロールの IndexNumber プロパティは、レコード取得メソッドを呼び出すときに VAccess コントロールで使用されるインデックスを決定します。このインデックスは、設計時に VAccess コントロールのプロパティウィンドウで設定するか、あるいは、実行時にコードで設定できます。

►設計時にインデックス番号を設定するには

プロパティウィンドウでは、IndexNumber プロパティのドロップダウンリストから値を選択してプロパティを設定できます。

次のように、プロパティページから IndexNumber を設定することもできます。

1 インデックス番号を設定する特定の VAccess コントロールを選択します。

2 右クリックしてプロパティページダイアログボックスを開きます。

3 VAccess1 プロパティページダイアログボックスの［Settings］タブをクリックし、IndexNumber フィールドをクリックします。選択したテーブルに定義されているインデックスのリストが表示されます。

4 インデックス 0－ID を選択し、［OK］をクリックします。図 5 に設定を示します。

図 5 IndexNumber プロパティの設定

実行時にインデックス番号を設定する方法として、コードによる方法と VAComboBox コントロールによる方法があります。

►実行時にコードによりインデックス番号を設定するには

1 インデックスを設定する VAccess コントロールをダブルクリックします。コードエディターが呼び出されます。

2 以下の例に倣って、コードを入力します。

VAccess1.IndexNumber = 0 '最初のインデックスを選択

►実行時にコンボボックスでインデックス番号を設定するには

1 フォームに VAComboBox を配置して選択します。

2 VAccessName プロパティを VAccess コントロールの名前に設定し、VAFieldName プロパティを［Index List］に設定します。VAComboBox にはファイルからインデックスのリストが自動的に設定され、このリストからの選択によって、VAccess コントロールで使用されるインデックスが設定されます。

自動と手動のファイルオープンの設定

VAccess コントロールは AutoOpen プロパティの設定状態に基づいて、2 つの方法のいずれかで PSQL データファイルを開きます（AutoOpen は設計時のみのプロパティです）。

•AutoOpen が True に設定されている場合、VAccess コントロールは DdfPath、TableName、および Location プロパティの設定に基づいて、実行時にファイルがロードされるとき、そのファイルを自動的に開きます。コントロールは、ファイルがアンロードされるときに自動的にファイルを閉じます。

•AutoOpen が False に設定されている場合、コントロールは Open メソッドが呼び出されるまでファイルを開きません。DdfPath、TableName および Location プロパティはプロパティウィンドウで設定するほか、Open の前にコードで設定できます。したがって、同じ VAccess コントロールで異なる時間に異なるファイルを開いたり、ファイルを選択するためにユーザー入力を受け入れることができます。Close メソッドは、開いているデータファイルを閉じます。

例も参照してください。

►AutoOpen プロパティを設定するには

プロパティウィンドウで AutoOpen プロパティを設定するには、ドロップダウンリストから True または False を選択します。

次のように、プロパティページから AutoOpen を設定することもできます。

1 コントロールを右クリックしてプロパティページを呼び出します。

2 ［Settings］タブをクリックします。

3 AutoOpen チェックボックスを選択または選択解除します。チェックボックスを選択すると、AutoOpen が True に設定されます。チェックボックスを選択解除すると、AutoOpen が False に設定されます。

例

この例は、AutoOpen が False に設定されている場合に、ファイルを閉じ、別のファイルを開く方法を示したものです。

'現在開いているファイルを閉じる

VAccess1.Close

' データ辞書情報を設定する

VAccess1.DdfPath = "<file_path>\PSQL\Demodata\"

VAccess1.TableName = "Student"

'ファイルを開く

VAccess1.Open

データソースへのバウンドコントロールのリンク

VAccess コントロールをフォームに追加してプロパティを設定した後、必要なバウンドコントロールを追加し、この VAccess コントロールにバインドすることができます。これにより、それらのバウンドコントロールは VAccess コントロールが指定するデータにリンクされます。特定のバウンドコントロールについては、ActiveX コントロールリファレンスを参照してください。

►PSQL バウンドコントロールのどれかをデータにリンクするには

1 バウンドコントロールの VAccessName プロパティを、既にデータをポイントしている VAccess データソースコントロールの名前に設定します。

2 VATextBox や VAOptionButton などのフィールドバウンドコントロールの場合は、VAFieldName プロパティをデータソースコントロール内のフィールドのうちの 1 つの名前に設定する必要もあります。

レコードの取得

以下の 3 つの方法でレコードを取得できます。

•VAHScrollBar または VAVScrollBar による方法

•VACommandButton による方法

•コードによる方法

►スクロールバーでレコードを取得するには

1 VAHScrollBar または VAVScrollBar をフォームに追加して選択します。

2 VAccessName プロパティを使用する VAccess コントロールに設定します。

►コマンドボタンでレコードを取得するには

1 フォームに VACommandButton を追加して選択します。

2 VAccessName プロパティを使用する VAccess コントロールの名前に設定し、VAOperation プロパティを希望の取得オペレーションに設定します。

使用可能な PSQL オペレーションの一覧については、VAOperation を参照してください。

►コードでレコードを取得するには

•表 3 のメソッドのうちの 1 つを使用します。Get メソッドは、IndexNumber プロパティで指定されたインデックスを使用します。Step メソッドはインデックスを使用しません。

表 3 個々のレコードを取得するためのメソッド
GetDirect	GetLast	StepFirst
GetEqual	GetLess	StepLast
GetFirst	GetLessOrEqual	StepNext
GetGreater	GetNext	StepPrevious
GetGreaterOrEqual	GetPrevious

例

' 人の名前を表示

' データ辞書情報を設定

'VAccess1.DdfPath = "<file_path>\PSQL\Demodata\"
'VAccess1.TableName = "Person"
'VAccess1.IndexNumber = 1 (Last_Name + 'First_Name)

Stat = VAccess1.GetFirst

While Stat = 0

List1.AddItem VAccess1.FieldValue("Last_Name") _

& " " & VAccess1.FieldValue("First_Name")

Stat = VAccess1.GetNext

Wend

特定のレコードの検索

以下の 2 つの方法で特定のレコードを検索できます。

•バウンドコントロールによる方法

•コードによる方法

►テキストボックスで特定のレコードを検索するには

1 フォームに VATextBox を配置します。

2 VATextBox の VASearch プロパティを True に設定します。これにより、テキストボックスにテキストが入力されると、一致するレコードを取得するために VAccess コントロールで GetGreaterOrEqual メソッドが実行されるようになります。

►コードで特定のレコードを取得するには

1 VAccess コントロールをダブルクリックします。

2 IndexNumber プロパティを設定して適切なインデックスを選択します。

3 FieldValue メソッドを使用して、検索する値をインデックスフィールドに設定します。複数のフィールドを使用するインデックスの場合は、必ず各フィールドに値を代入してください。

4 次に、表 4 のメソッドのうちの 1 つを実行して目的のレコードを取得します。

表 4 特定のレコードを取得するためのメソッド
GetEqual	キーと一致する最初のレコードを返します。
GetGreater	キーより後の次のレコードを返します。
GetGreaterOrEqual	キーレコード、またはキーより後のレコードを返します。
GetLess	キーより前のレコードを返します。
GetLessOrEqual	キーレコード、またはキーより前のレコードを返します。

5 IndexNumber プロパティが、検索が行われるフィールドに対応するインデックスに設定されていることを確認してください。

例

' キーフィールドに検索値を入力

VAccess1.FieldValue("last_name") = "Reich"

VAccess1.FieldValue("first_name") = "Steve"

' 正しいインデックス番号を設定してレコードを取得

VAccess1.IndexNumber = 1

stat = VAccess1.GetEqual

If stat = 0 Then

MsgBox "レコードが見つかりました。"
Else

MsgBox "ファイルには該当するレコードがありません。"

End If

レコードの追加、更新、および削除

レコードを追加、更新または削除する方法として、以下の 2 つの方法があります。

•VACommandButton による方法

•コードによる方法

►コマンドボタンでレコードを追加、更新、または削除するには

1 フォームに VACommandButton を配置します。

2 VAccessName プロパティを対応する VAccess コントロールの名前に設定します。

3 VAOperation プロパティを希望のオペレーションに設定します。可能なオペレーションのリストについては、本書の「プロパティリファレンス」の VAOperation プロパティを参照してください。

►コードでレコードを追加、更新、または削除するには

以下の VAccess コントロール用カスタムメソッドの 1 つを使用し、コードからデータベースへの書き込みを行います。

表 5 レコードを追加、更新および削除するためのカスタムメソッド
Delete	現在のレコードを削除します。
Insert	メモリ内のレコードを新しいレコードとして挿入します。
Update	現在のレコードをメモリ内のレコードで更新します。

例

' 指定された学生の専攻科目を変更

VAccess1.TableName = "Student"

VAccess1.IndexNumber = 1

VAccess1.FieldValue (ID) = 2001100

stat = VAccess1.GetEqual

If stat = 0

VAccess1.FieldValue ("Major") = "Music"

VAccess1.Update

End If

レコードのロック

PSQL には、ActiveX アクセス方法でサポートされる次の 2 種類のロックがあります。単一レコードノーウェイトロックと複数レコードノーウェイトロックです。

ActiveX アクセス方法でこれらのロックを適用するには、以下のアプローチのうちの 1 つを使用します。

•VACommandButton を使用してレコードの取得とロックを行う場合は、VALockBias プロパティを設定します。

•Get または Step メソッドを呼び出すときは、オプションパラメーターとして対応するロックバイアス（単一レコードの場合は 200、複数レコードの場合は 400）を含めます。

レコードをロック解除するには、Unlock メソッドを使用します。

レコードロックと並行制御の詳しい説明については、『PSQL Programmer's Guide』のデータ整合性を参照してください。

例

'レコードをロックし、学生の名前を変更して、レコードを更新する

Const SINGLE_NOWAIT_LOCK = 200

Const MULTIPLE_NOWAIT_LOCK = 400

VAccess1.FieldValue("ID") = "<valid #>"

' ロックバイアス付きのロックをかけてレコードを取得

stat = VAccess1.GetEqual SINGLE_NOWAIT_LOCK

' 学生の名前を変更してレコードを更新

' レコードの更新によりロックが解除される

If stat = 0

VAccess1.FieldValue("Major") = "Astronomy"

VAccess1.Update

End If

ファイルの結合

VAccess コントロールの Join プロパティを使用すると、2 つのファイルをキー値でリンクし、第 1 ファイルのレコード位置におけるあらゆる変更が、第 2 ファイルから取得されるレコードにも反映されるようにすることができます。Join プロパティは、リレーショナルデータベースを参照するための簡単なメカニズムを提供します。

スレーブコントロール内の結合済みフィールドはインデックスフィールドである必要があり、また、マスターコントロール内の対応するフィールドと同じ生データが含まれていなければなりません。マスターコントロール内のフィールドは、インデックスである必要はありません。スレーブコントロールの IndexNumber プロパティは、結合に関係するインデックスに設定されたままにしておく必要があります。そうしないと、結合が断たれます。

1 対 1、多対 1、1 対多、多対多の結合はすべてサポートされます。VAListBox の VAccessName プロパティをスレーブコントロールの名前に設定し、VAFieldName プロパティを表示されるフィールドに設定することによって、データをレコードリストモードで表示できます。

►2 つの VAccess コントロールを結合するには

1 スレーブコントロールとする VAccess コントロールを選択します。

2 プロパティウィンドウで、［Join］ボタンをクリックして［Join Controls］ダイアログボックスを開きます。ダイアログボックスの左側には、結合元のスレーブコントロールのテーブルとそのテーブルの選択したインデックスが表示されます。右側には、結合先のマスターコントロールとそのコントロールで使用できるフィールドが表示されます。

3 マスターコントロールをスレーブコントロールのテーブルに結合するには、マスターコントロールのフィールドをクリックします。そうすると、Equals 列の下にフィールドが表示され、そのフィールドが結合されていることを示します。

Extended オペレーションの有効化

Extended オペレーションを使用すると、複数のレコードに対するリクエストの処理を MicroKernel エンジンにさせることが可能になります。ネットワークサーバーベースの PSQL システムでは、Extended オペレーションによってネットワークトラフィックを大幅に削減し、データ取得を高速化することができます。

Extended オペレーションは、複数のレコードを一度に読み取る際に最も有効です。たとえば、統計データを収集して表に記入するためにファイルをスキャンしたり、表、レポートまたはグリッドを作成するために多数のレコードを一度に要求したり、必要なレコードを照合するための適切なインデックスを持たないデータベースに対する一度限りの検索を実行するのに適しています。

Extended オペレーションは個々のレコードにアクセスするためのインデックス付きレコード取得に代わるものではなく、データセットを高速に取得するための強力なツールになります。

►Extended オペレーションを使用可能にするには

1 Extended オペレーションで使用する VAccess コントロールを選択します。

2 プロパティウィンドウを使用している場合は、ExtendedOps プロパティを True に設定します。プロパティページを使用している場合は、［Extended Operations］タブをクリックし、［ExtendedOps］チェックボックスをオンにして、［OK］をクリックします。

ActiveX アクセス方法は以下の Extended Fetch メソッドをサポートします。

•Get Next Extended は、現在のキーの論理位置より後続のレコードのうち、指定されたフィルター条件を満たすレコードを取得します。

•Get Previous Extended は、現在のキーの論理位置より前にあるレコードのうち、指定されたフィルター条件を満たすレコードを取得します。

•Step Next Extended は、ファイル内における物理位置より後続のレコードのうち、指定されたフィルター条件を満たすレコードを取得します。

•Step Previous Extended は、ファイル内における物理位置より前にあるレコードのうち、指定されたフィルター条件を満たすレコードを取得します。

Init メソッドの使用

Init メソッドは、SelectedFields または SelectedRecords プロパティを変更した後、あるいは、単一レコードのフェッチメソッドを使ってファイル内の現在のカーソル位置を再設定してから Extended Fetch メソッドを呼び出すまでの間に使用します。

AutoMode プロパティによるデータ「スナップショット」の構築

AutoMode を有効にすると、VAccess データソースは選択基準を満たす行が取得されるときにそれらをすべてメモリにキャッシュして、データの「スナップショット」を構築できるようにします。Row プロパティを使用して返されたレコードセットを走査したり、RowColumnValue メソッドを使用してレコードセット内の任意の行と列における値を取得することができます。

►AutoMode を使用するには

1 VAccess コントロールの ExtendedOps と AutoMode プロパティを True に設定して、Extended オペレーションを使用可能にし、コントロールを自動モードに切り替えます。

2 コントロールの SelectedFields と SelectedRecords プロパティを設定して、取得するレコードセットを指定します。

3 取得オペレーションごとに取得する最大レコード数を CacheRows プロパティに設定します。

4 ユーザーがスキャンを終了する前にスキャンを取り消せるようにする場合は、CancelDialog プロパティを True に設定します。

AutoMode は環境によっては Extended オペレーションを使いやすくしますが、使用可能メモリの制限を受けます。AutoMode を無効（デフォルト）にして、明示的な Extended Fetch メソッドの GetNextExtended、GetPreviousExtended、StepNextExtended、または StepPreviousExtended を使用すれば、考慮したブロックでデータセットを返すことができます。

Extended Fetch メソッドの使用

Extended Fetch メソッドの GetNextExtended、GetPreviousExtended、StepNextExtended および StepPreviousExtended はファイル内の現在のカーソルの位置から始まり、指定された選択基準を満たす一連の行（レコード）と列（フィールド）を返します。Get メソッドは、現在のインデックスを使用してインデックス順にレコードを返します。Step メソッドは、物理位置の順序で並べられたレコードを返します。Step メソッドは一般にほかのメソッドより高速なので、返されるレコードの順序が重要でない場合に使用してください。

特定の Extended Fetch オペレーションから返される最大レコード数の設定には、いくつかのプロパティが関与します。

•単一の Extended Fetch オペレーションから返されるデータの総量は、MaxBufferSize プロパティで指定するデータ通信バッファーのサイズによって制限されます。このバッファーは最大 64 KB ですが、PSQL MicroKernel データベースエンジンの設定によってはこれより小さくなります。このプロパティに大きすぎる値を指定すると、ステータスコード 97、「データバッファーが小さすぎます」が返されます。

•SelectedFields プロパティは個々のデータ行のサイズを決定しますが、このサイズは選択されたフィールドの記憶域の長さの合計に 6 バイトを加えた長さです。

•CacheRows パラメーターは、一度に取得する最大行数を指定します。Extended Fetch メソッドは、CacheRows の値か、行のサイズと MaxBufferSize に基づいた計算値のいずれか小さい値を使用します。CacheRows がゼロであれば、計算値が使用されます。

•SelectedRecords プロパティを使用すると、ある基準を満たすレコードだけを取得できます。このプロパティは CacheRejectMax プロパティと結び付いて機能し、検索条件に合わないレコードをスキップします。CacheRejectMax プロパティに値を指定しないと、PSQL はシステムで定義された値を使用します。次の 2 つの条件のうちの 1 つが満たされると、レコードセットが返されます。つまり、選択基準を満たす行数が CacheRows プロパティの値に等しくなるか、あるいは、最後の一致を検出して以降にスキャンされたレコード数が CacheRejectMax プロパティの値を超えるという条件です。Status プロパティは、いずれの条件が満たされたかを示します。

•Rows プロパティは、Extended Fetch オペレーションから返された行数を示します。Extended Fetch の後には必ず、このプロパティの値をチェックしてください。オペレーションがゼロ以外のステータス（ファイルの終わりなど）を返しても、有効なデータを返す可能性があるからです。

•Columns プロパティは、SelectedFields プロパティで指定されたフィールド数に対応するか、レコード選択基準を指定しなかった場合は、ファイルに定義されているフィールド数に対応します。

•RowColumnValue メソッドは、Extended Fetch レコードセット内の指定された行および列の位置にあるフィールド値を取得します。

Extended Fetch オペレーション後の現在のカーソル位置は、オペレーションでスキャンされた最後のレコードに対応します。このカーソル位置は、レコード選択基準が指定されているアプリケーションでは不確定です。なぜなら、この位置は実際に取得された最後の行を超えている可能性があるからです。

IncludeCurrent プロパティの設定によって、次の Extended Fetch オペレーションが現在のカーソル位置のレコードをスキャンするか、後続のレコードから開始するかが決まります。ほとんどの場合、このプロパティを設定する必要はありません。このプロパティは自動的に、Init メソッドで True に設定され、Extended Fetch の後に False に設定されます。それ以降の Extended Fetch オペレーションで現在のカーソル位置のレコードを取り込むには、オペレーションの直前にこのプロパティに True を設定します。

結合ファイルに対する ExtendedOps の使用

ExtendedOps プロパティは、典型的な「品目を注文するための注文ヘッダーレコード」などに見られるような、1 対多関係の VAccess データコントロールの結合を高速化かつ単純化することができます。結合されたデータソース（この例では「注文明細行」コントロール）に対して Extended オペレーションを有効にすると、適応するクエリが自動作成され、コントロールは Extended オペレーションを使って結合（Join）を実行し、結合基準に合致する結合ファイルから、すべてのレコードを Extended Fetch のレコードセットとして返します。

Extended Fetch の最適化

Extended Fetch オペレーションを最も効率よく使用するには、まず、検索条件に合う最初のレコードのできるだけ近くにカーソルを置きます。多くの場合、まず GetEqual または GetGreaterOrEqual メソッドをインデックスと併用して、PSQL が必要なレコードを返すためにスキャンしなければならないレコードの範囲を制限し、初期位置を確立してから、次に GetNextExtended を使用して後続のレコードを取得できます。

CacheRejectMax プロパティは、SelectedRecords の基準で現在のインデックス上のレコードが制限される場合に有効です。たとえば、CacheRejectMax プロパティの値を 1 に設定すると、PSQL サーバープロセスに対し、基準に合わない最初のレコードを見つけたら停止するよう指示することができます。

ファイル全体をスキャンする必要があってもレコードの順序が重要でない場合は、StepFirst メソッドでファイルの先頭にカーソルを置き、StepNextExtended メソッドでファイルをスキャンすることによって、時間をある程度節約できます。Step メソッドの方が一般に高速なのは、インデックスパスに沿ってレコードを照合する必要がないからです。

SelectedFields プロパティに入手したいフィールドのみを指定することによっても、時間とリソースを節約できます。Extended Fetch オペレーションの制限要因はデータバッファーのサイズなので、各行に必要なメモリが少ないほど、一度に返せる行が多くなります。

ここで、Extended オペレーションは別のタスク、一般には PSQL サーバープロセスで実行されるため、アプリケーションは拡張クエリを実行するとすぐにプロセスの制御を放棄し、クエリ条件が満たされるまでもう 1 つのプロセスが制御を引き受けるということに留意してください。したがって、拡張クエリを計画し最適化すれば、アプリケーションのパフォーマンスに大きな差が出てくる可能性があります。

例

' 奨学金を受けているすべての学生の ID を出力

Q = Chr$(34)

' Student ID はインデックスなので、レコードの並べ替えに使用できます。

' しかし、選択条件にはインデックスがありません。したがって、データベース全体を

' スキャンする必要があります。効率を上げるため、Extended オペレーションを使用します。

VAccess1.ExtendedOps = True

' レコード選択条件を指定することにより、PSQL がサーバーで

' レコードにフィルターをかけるようにできます。

VAccess1.SelectedRecords = "Scholarship_Amount > " & Q & "0" & Q

' 必要なのは金額と Student ID だけなので、

' この情報を返すだけで、一度により多くのレコードを取得することができます。

VAccess1.SelectedFields = "ID,Scholarship_Amount"

' データの並べ替えは不要なので、Step オペレーションを使用します。

' Step オペレーションは物理位置に基づいているので、

' データベースを最も速く読むことができます。

VAccess1.StepFirst

VAccess1.Init

Stat = VAccess1.StepNextExtended

' 注意：Extended フェッチは、ファイルの終わり（9）のようなステータス値を

' 返しても有効なデータを返すことがあります。

For R = 1 to VAccess1.Rows

List1.AddItem VAccess1.RowColumnValue(R, 1) & Chr$(9) & _

Format(VAccess1.RowColumnValue(R, 2), "Currency")

Next R

Loop While Stat = 0

PSQL ActiveX ファイルの配布と登録

PSQL アプリケーションの配布については、『PSQL Programmer's Guide』の PSQL アプリケーションの配布を参照してください。

次の表に、ActiveX アクセス方法を使って構築されたアプリケーションの実行に必要なファイルを示します。

表 6 再配布可能なファイル
ファイル	場所	説明
ACBTR732.OCX	<file_path>\PSQL\bin\	PSQL データソースコントロール
ACCTR732.OCX	<file_path>\PSQL\bin\	PSQL バウンドコントロール
PEDTCONV.DLL	<file_path>\PSQL\bin\	データ変換用 DLL
PBTRVD32.DLL	<file_path>\PSQL\bin\	メタデータ処理用 DLL

PSQL ファイルのデフォルトの保存場所については、『Getting Started with PSQL』の PSQL ファイルはどこにインストールされますか？を参照してください。

PSQL ActiveX ファイルと必要な DLL を配布した場合、ActiveX ファイルが正しく機能するように ActiveX ファイルを登録する必要があります。これらのファイルを登録するには次の 2 種類の方法があります。

•InstallShield などの現行のインストール用ユーティリティの多くは、インストール処理中に ActiveX コントロールを自動的に登録するよう変更することができます（詳細については、お使いになる特定のインストール用ユーティリティのマニュアルを参照してください）。

•ActiveX コントロールを登録するもう 1 つの方法は、再配布可能なファイル REGSVR32.EXE をインストールし、インストール中またはインストール後に実行する方法です。これは単純な ActiveX 登録用ユーティリティで、登録する ActiveX の名前をコマンドラインパラメーターとして受け取ります（たとえば、REGSVR32 C:\MyInstall\ACBTR732.OCX）。

ActiveX アクセス方法に関する追加情報

このマニュアルのほかにも、ActiveX アプリケーションの開発に役立つリソースがあります。これらの項目は以下のとおりです。

•Actian PSQL Web サイトは、PSQL 開発者のための多くの種類の情報を提供しています。

•Status Codes and Messages －このマニュアルでは、PSQL のコンポーネントを使用しているときに発生する可能性のある各ステータスコードとメッセージについて説明しています。