ActiveX Controls Guide (v11)

DdfAddTable (ActiveX メソッド)

適用対象

VAccess

説明

TableNameLocationFieldListIndexList の値によって定義される現在のテーブルを現在の DDF に追加します。

構文

object.DdfAddTable bOverwrite 

DdfAddTable メソッドの構文は次のような要素で構成されます。

要素
説明
object
必須。有効な VAccess コントロールの名前です。
bOverwrite
必須。既存のテーブル定義が存在する場合に、VAccess コントロールがその定義を上書きするかどうかを指定するブール値です。

戻り値

DdfAddTable は、VAccess コントロールのステータスを保持する 2 バイトの整数を返します。この値がゼロの場合、オペレーションは正常に終了しています。

備考

DdfAddTable は VAccess コントロールの現在のメモリ イメージにある情報を DDF ファイル自体に書き込みます。bOverwrite が True の場合、コントロールは同じ名前を持つ既存テーブルを上書きします。False の場合は、同名のテーブルが(DdfPath プロパティで指定された)現在の DDF に存在すると、このメソッドはエラーとなります。

この関数はメタデータの VAccess メモリ イメージやデータ ファイル自体を操作することはありません。新しい空のテーブルをメタデータの VAccess メモリ イメージに作成するには、DdfAddTableName メソッドを使用します。新しいテーブルを DDF および指定された場所にある対応する空のデータ ファイルに作成するには、DdfCreateTable メソッドを使用します。

ほかの多くの辞書メソッドやプロパティと異なり、DdfAddTableRefreshLocations をチェックしません。これは DDF 情報を書き込むためだけに使用されるので、直接 DDF に書き込むことを想定しています。この動作は、VAccess メモリ イメージを使用して、一度のパスで DDF への変更を保管し、それらの変更を DDF へ書き込むつもりならば、RefreshLocations を切り替える必要はないということです(『Pervasive PSQL Programmer's Guide』を参照)。

DdfTransactionModeTrue の場合、DDF への書き込みはトランザクション内部で実行されます。

'フィールド、インデックス、テーブル名、および場所は既に設定されているものと仮定 
VAEngine.FieldList = fields 
VAEngine.IndexList = indexes 
VAEngine.fileName = tableName 
VAEngine.location = location 
status = VAEngine.DDFAddTable(True) 

関連項目

DdfAddTableName、DdfCreateTable、DdfTransactionMode


DdfAddIndex (ActiveX メソッド)

DdfAddTableName (ActiveX メソッド)