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

データ辞書ファイル（DDF）は、Pervasive PSQL データに対する列レベルのアクセスを行うために、Pervasive PSQL アプリケーションや多数のサードパーティ アプリケーションで使用されます。ActiveX アクセス方法は、Pervasive PSQL 開発者が DDF の作成、読み取りおよび変更を容易に行えるようにする多数のメソッドを提供します。

辞書ファイル処理のほとんどで、コントロールへの新しいメソッドの追加が必要です。ただし、旧バージョンの ActiveX データ ソース コントロールはデータ辞書を認識したため、既存のプロパティとメソッドの動作にいくつかの変更が加えられました。旧バージョンとの互換性は保たれていますが、RefreshLocations などのように拡張されたプロパティがある一方、FieldInde や FieldName などのように使用が推奨されなくなったものもあります。

ActiveX データ ソース コントロールは DDF から情報を読み取り、必要に応じて内容をキャッシュに格納します。つまり、辞書には、DDF 自体の内容と、DDF ファイルに関する ActiveX アクセス方法コントロールのメモリ イメージの内容という 2 つのバージョンが常に存在します。ActiveX コントロールのバージョン 3 では、コントロールが DDF 情報を DDF 自体から読み取るか、または、保持しているメモリ イメージから読み取り、アプリケーションの起動時間を節約するかを RefreshLocations プロパティが決定していました。

この機能は維持されていますが、RefreshLocations の意味は、オペレーションを実行するために DDF 自体を使用するか、あるいは辞書情報に関する ActiveX コントロールのメモリ イメージを使用するかを示すように拡張されました。

言い換えると、オペレーションがコントロールのメモリ イメージまたは DDF を参照できる場合は、RefreshLocations を False に設定すれば、コントロールはメモリ イメージのみを使ってオペレーションを処理するように制限されます。RefreshLocations が True である場合、オペレーションはメモリ イメージとファイル自体に作用します。したがって、RefreshLocations は ActiveX コントロールの DDF 処理用メソッドとプロパティの多くに作用する優先プロパティです。

以前のバージョンの ActiveX アクセス方法は、DDF に含まれる情報の大部分を公開していましたが、特定の情報を取り出すのが非常に困難であったり、ときには不可能なことがありました。また、項目ごとに複数のプロパティ設定が必要だったので、情報の複数の項目を検索することは面倒でした。本バージョンの ActiveX アクセス方法では、これらの問題の解決にバリアント配列を使用しました。バリアントとは、複数のデータ型を表すことができ、かつどのデータ型を現在表しているかがわかる変数の一種です。ActiveX アクセス方法コンテナーはバリアントをサポートします。

バリアント配列はバリアントの一種で、実質的にはバリアントのリストへの参照であり、リストの各項目に異なる型の情報を保持できるものです。この配列は、コード環境によって異なる方法で表されます。Visual Basic では、バリアント配列は myArray（1, 1）のような単なる通常の配列として表示されます。しかし、Visual C++ では、バリアント配列は VT_ARRAY|VT_VARIANT 型のバリアントにすぎず、"SafeArray" システム API を使用して配列の内容を処理する必要があります。

既に述べたように、ActiveX アクセス方法はバリアント配列を使用してコア DDF 情報を公開します。ActiveX インターフェイスが使用する配列は、1 次元として列、2 次元として行を持つ 2 次元配列です。この配列では、Visual Basic ユーザーは ReDim Preserve 関数を使用して行数を変更することができます。列は要求された情報のさまざまな面を表すのに対して、行は項目の集合を表します。たとえば、GetTableList は 2 次元配列を返します。1 次元は 3 つの情報、つまり、TableID、TableName、および TableLocation から構成されているのに対して、2 次元は辞書内のテーブルごとに 1 行を含んでいます。したがって、Visual Basic におけるテーブル名のリストの取得は以下のように行われます。

FieldList と IndexList は、ほとんど同じ機能を果たします。ただし、これらはプロパティであるため、配列のエントリを変更したり、エントリを追加することができます。各配列の 1 次元の構造については、FieldList と IndexList を参照してください。言うまでもなく、各配列の 2 次元はフィールド数またはインデックス数を表します。

ActiveX メモリ イメージでのファイルの変更は、DDF の新しい定義を追加または変更してコミットする最初の段階として、また、間違った DDF の情報を修正する場合において有用です。必要とされる変更のほとんどは、FieldList プロパティおよび IndexList プロパティを使用して行うことができます。

DDF を変更する場合は、すべての変更がコミットできる状態になるまで ActiveX メモリ イメージに変更情報を保管しておき、その後 DdfAddTable を使用してファイルに変更情報をコミットする方が効率的です。したがって、FieldList または IndexList を設定するときは RefreshLocations を False に設定することをお勧めします。Visual Basic では、ReDim 関数で Preserve オプションを使用すれば、既存の定義にフィールドを追加することができます。また、DdfModifyTableName と DdfModifyLocation を使用して、現在のメモリ イメージまたは DDF ファイル自体に含まれるテーブルを変更することもできます。たとえば、次のようにします。

ActiveX アクセス方法のメモリ イメージ（および DDF）でテーブルを作成することは、データ ファイルに関連付けられた DDF エントリがない場合や、新しいテーブルを作成する場合に有用です。このプロセスには、以下の 3 つの基本的な手順があります。

新しいテーブルを作成する場合は、この後に第 4 の手順、つまり、データ ファイルの作成を行います。

空のテーブルを作成するとき、ActiveX アクセス方法は現在のメモリ イメージに作業テーブルがなく、すべてのフィールドおよびインデックス情報が消去されていることを認識できる必要があります。DdfAddTableName がこの機能を果たします。現在のテーブル メモリ イメージを DDF に追加する DdfAddTable や、現在のテーブル名を変更しても他のすべての情報を保つ DdfModifyTableName と違い、DdfAddTableName は現在のテーブル リストに追加スロットを作成し、空のテーブルに関連するすべてのフィールドおよびインデックス情報を消去します。この作業を行うときは、DDF に空のテーブルを作らないよう、RefreshLocations を False に設定することをお勧めします。

DdfModifyLocation、FieldList および IndexList オペレーションを使用して、新しい空のメモリ イメージを作成することができます。次に、DdfAddTable を使用して DDF にそのイメージを書き出すことができます。

アプリケーションで辞書自体を作成しなければならない場合があります。たとえば、アプリケーションが初めて実行されたときに必要な DDF を作成するようにアプリケーションを書いて、ベンダーがアプリケーションと一緒に DDF を出荷および更新しなくて済むようにすることができます。このタスクを行うメソッドとして、DdfCreateDictionary があります。このメソッドは、DdfPath ディレクトリに空の辞書ファイル（COMMENT.DDF と FIELDEXT.DDF も含む）を作成します。

これまで説明してきた変更はすべて、DDF または DDF の ActiveX メモリ イメージにだけ当てはまるものです。ただし、DDF を変更しても、データ ファイル内の実際のレコードの長さや構造は変更されません。この変更を行うには、データ ファイルに直接影響を与える関数を使用する必要があります。

データ ファイルの長さの変更は、1 つの操作で済む問題ではありません。基本的には、データ ファイルを破壊し、新しい長さで再構築する必要があります。既存のファイルに対してこの変更を行う場合は、2 つの VAccess コントロールとテンポラリ ファイルを使用してレコードをコピーする必要があります。たとえば、次のようにします。

その他にも、データ ファイルのインデックス構造に対して直接行える変更があります。これらの操作は ActiveX メソッド リファレンスに示されており、DdfAddIndex、DdfDropIndex、および DdfDropIndexMaintain などがあります。

ここで説明するメソッドを使用して、さまざまな目的で DDF を処理することができます。

オーナー ネームで DDF をセキュリティ保護することができます。この機能を果たすために、以下の 2 つの方法が用意されています。

これらの 2 つの方法の詳細については、ActiveX メソッド リファレンスを参照してください。

DdfClearFields と DdfClearIndexes は、現在のテーブルの既存のフィールド情報およびインデックス情報をすばやく消去できる便利な方法を提供します。

DdfGetComments。このメソッドの用途は非常に限定的です。RefreshLocations が False である場合、DDF 以外のテーブルを開いているときは永続的なメモリ イメージが読み取られます。ただし、永続的なメモリ イメージにはコメント情報が含まれていません。DdfGetComments は RefreshLocations を無視するため、このメソッドを使用してコメント情報を永続的な DDF の情報と同調させるように ActiveX を強制設定することができます。

最後に、次の 2 つのメソッドは DDF を扱うオペレーションに対して広範囲の影響を与えます。