|
VAccess
TableName、Location、FieldList、IndexList の値によって定義される現在のテーブルを現在の DDF に追加します。
DdfAddTable メソッドの構文は次のような要素で構成されます。
要素
|
説明
|
---|---|
object
|
必須。有効な VAccess コントロールの名前です。
|
bOverwrite
|
必須。既存のテーブル定義が存在する場合に、VAccess コントロールがその定義を上書きするかどうかを指定するブール値です。
|
DdfAddTable は、VAccess コントロールのステータスを保持する 2 バイトの整数を返します。この値がゼロの場合、オペレーションは正常に終了しています。
DdfAddTable は VAccess コントロールの現在のメモリ イメージにある情報を DDF ファイル自体に書き込みます。bOverwrite が True の場合、コントロールは同じ名前を持つ既存テーブルを上書きします。False の場合は、同名のテーブルが(DdfPath プロパティで指定された)現在の DDF に存在すると、このメソッドはエラーとなります。
この関数はメタデータの VAccess メモリ イメージやデータ ファイル自体を操作することはありません。新しい空のテーブルをメタデータの VAccess メモリ イメージに作成するには、DdfAddTableName メソッドを使用します。新しいテーブルを DDF および指定された場所にある対応する空のデータ ファイルに作成するには、DdfCreateTable メソッドを使用します。
ほかの多くの辞書メソッドやプロパティと異なり、DdfAddTable は RefreshLocations をチェックしません。これは DDF 情報を書き込むためだけに使用されるので、直接 DDF に書き込むことを想定しています。この動作は、VAccess メモリ イメージを使用して、一度のパスで DDF への変更を保管し、それらの変更を DDF へ書き込むつもりならば、RefreshLocations を切り替える必要はないということです(『Pervasive PSQL Programmer's Guide』を参照)。
DdfTransactionMode が True の場合、DDF への書き込みはトランザクション内部で実行されます。
'フィールド、インデックス、テーブル名、および場所は既に設定されているものと仮定 VAEngine.FieldList = fields VAEngine.IndexList = indexes VAEngine.fileName = tableName VAEngine.location = location status = VAEngine.DDFAddTable(True)
DdfAddTableName、DdfCreateTable、DdfTransactionMode
|