Возвращает копию объекта IZbTableDef. Новый объект можно редактировать, например для изменения структуры таблицы с помощью метода AlterTable.

Применяется к:

IZbTableDef

Синтаксис:

Visual Basic:

Function Clone() As IZbTableDef

Описание

Обычно для изменения структуры таблицы необходимо получить её текущую структуру (объект IZbTableDef), внести необходимые изменения и выполнить метод AlterTable объекта ZbDatabase.

Объект IZbTableDef может быть получен либо через метод GetTableDef объекта ZbDatabase, либо через свойство TableDef объекта IZbTableInfo. Во втором случае возвращаемый объект является read-only, отражает текущее состояние структуры таблицы и не может быть изменён. Чтобы изменить структуру таблицы можно выполнить метод Clone, чтобы получить копию объекта, внести в неё изменения и потом выполнить AlterTable.

Пример

'Пример Visual Basic
Dim OldTableDef As IZbTableDef
Dim NewTableDef As IZbTableDef

'Получаем текущую структуру таблицы
OldTableDef = TableInfo.TableDef

'Создаём копию структуры таблицы
NewTableDef = OldTableDef.Clone

'Добавляем новое поле
NewTableDef.AddField "NewField", zbftInteger, 0, 0, False

'Выполняем реструктуризацию
Db.AlterTable TableInfo.Source, TableInfo.Name, NewTableDef