Шаг 157 - Объект TableDef

Описание
Объект TableDef (таблица) представляет сохраненное определение основной таблицы или присоединенной таблицы (только в рабочей области Microsoft Jet).

Замечания
Работа с определением таблицы проводится с помощью объекта TableDef и его методов и свойств. Например, данный объект позволяет:

1. Выполнить в базе данных просмотр структуры полей и индексов любой локальной, присоединенной или внешней таблицы.
2. Прочитать или задать значения свойств Connect (подключение) и SourceTableName (имя таблицы-источника) для присоединенных таблиц и вызвать метод RefreshLink для обновления связей с присоединенными таблицами.
3. Прочитать или задать значения свойств ValidationRule и ValidationText, определяющих условия на значение.
4. Использовать метод OpenRecordset для создания на основе описания таблицы объекта Recordset типа таблицы, динамического набора записей, объекта динамического типа, статического набора записей или статического набора записей с последовательным доступом.

Для основных таблиц свойство RecordCount содержит число записей в указанной таблице базы данных. Для присоединенных таблиц свойство RecordCount всегда имеет значение -1.
Для создания нового объекта TableDef используется метод CreateTableDef.

Добавление поля в таблицу:

1. Проверьте, что все объекты Recordset, базирующиеся на этой таблице, не открыты ни одним пользователем.
2. Вызовите метод CreateField, чтобы создать объектную переменную для объекта Field и задать ее свойства.
3. Добавьте объект Field в семейство Fields объекта TableDef с помощью метода Append.

Допускается удаление объекта Field из семейства TableDefs, если этот объект не был использован при создании индексов, однако, при этом будут потеряны все содержащиеся в поле данные.
Создание в базе данных новой таблицы:

1. Вызовите метод CreateTableDef для создания объекта TableDef.
2. Задайте свойства объекта.
3. Для каждого поля в таблице создайте объектную переменную для объекта Field и задайте ее свойства с помощью метода CreateField.
4. Добавьте объект Field в семейство Fields объекта TableDef с помощью метода Append.
5. Добавьте новый объект TableDef в семейство TableDefs объекта Database с помощью метода Append.

Присоединение таблицы к базе данных:

1. Вызовите метод CreateTableDef для создания объекта TableDef.
2. Задайте значения свойств Connect и SourceTableName (и, при необходимости, свойства Attributes).
3. Добавьте объект TableDef в семейство TableDefs объекта Database с помощью метода Append.

При ссылках на объект TableDef используют его порядковый номер в семействе или значение свойства Name(имя):

TableDefs(0)

TableDefs("имя")

TableDefs![имя]