ActiveX Controls Guide (v11)

DdfModifyTableName (ActiveX メソッド)

適用対象

VAccess

説明

現在のテーブルの名前を変更し、オプションとして DDF に新たな名前を書き込みます。

構文

object.DdfModifyTableName newName 

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

要素
説明
object
必須。有効な VAccess コントロールの名前です。
newName
必須。テーブルの新しい名前を含む文字列です。

戻り値

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

備考

DdfModifyTableName は現在のテーブルを変更しません。要求された名前のテーブルが既に存在する場合はエラーとなります。現在のテーブルを変更するには、TableName プロパティを使用します。現在のテーブル一覧に新しい空のテーブルを追加するには、DdfAddTableName を使用します。

RefreshLocationsTrue の場合、新しいテーブル名は、データ辞書の FILE.DDF レコードでも更新されます。False の場合は、VAccess メモリ イメージに対してのみ変更が行われます。DdfAddTable を使用して後から変更することもできます。

このメソッドにより、コントロールの TableName プロパティの値も新しい名前を反映して変更されます。

関連項目

RefreshLocations、TableName、DdfAddTable、DdfAddTableName、DdfModifyLocation


DdfModifyLocation (ActiveX メソッド)

DdfSetOwner (ActiveX メソッド)