Таблица

Создаёт объект на основе таблицы базы данных или внешнего файла.

Синтаксис

Таблица(ИмяТаблицы[, ТолькоДляЧтения])

Параметры

ИмяТаблицы (текст) – имя таблицы базы данных или имя внешнего файла. В первом случае указывается логическое имя таблицы, то есть не имя файла с таблицей, а то, как эта таблица именуется в программе, например, "Организации", "Документ" и так далее. Необходимо указывать точное название таблицы, учитывая регистры.

Во втором случае указывается физическое имя файла. Программа понимает файлы с расширениями – ".dbf" (файлы СУБД DBase, FoxPro). Именно по наличию в параметре одного из этих расширений программа определяет, что указано имя таблицы или имя файла. Если в имени файла не указан каталог, то файл ищется в том каталоге, откуда была запущена программа.

Файл ".dbf" обязательно должен существовать, иначе будет выдано сообщение об ошибке.

ТолькоДляЧтения (логическое значение) – значение "Да" разрешает только просмотр открываемой таблицы. Если в качестве параметра указать "Нет", то запись можно редактировать. В режиме "только для чтения" одна и та же таблица может быть открыта несколько раз, при этом навигация по каждой из открытых таблиц осуществляется независимо от всех остальных. Но при попытке открыть одну таблицу в разных режимах будет выдано сообщение об ошибке.

Возвращает

Объект, содержащий запись указанной таблицы или внешнего файла. Возвращаемый функцией объект не содержит каких-либо реальных данных, все поля записи пусты. Для извлечения записи из базы данных можно использовать функции "Найти", "Следующий", "Предыдущий" и так далее.

Примеры

оРасч = Таблица("Расчетные счета"); # определяем пустой объект оРасч на основе таблицы "Расчётные счета".

В случае dbf-файлов можно обращаться непосредственно к именам полей в исходном файле. Так в следующем примере идёт обращение к полю с именем "ИНН".

оЗапись = Таблица("man.dbf");
Пока(Следующий(оЗапись))
   Сообщить(оЗапись.ИНН);

С помощью ниже приведенного фрагмента будет выведен список всех имен пользователей, причем после каждого имени будет выдаваться сообщение о том, какой пользователь идет следующим:

перем пТ1  = Таблица( "Пользователи.tbl", ДА );
перем пТ2 = Таблица( "Пользователи.tbl", ДА );
Следующий( пТ2 );
Пока( Следующий( пТ1 ) )
{
   Следующий( пТ2 );
   Сообщить( пТ1.Имя + " Следующий: " + пТ2.Имя );
}

См. также:

•  ЗаписьТаблицы

•  НазваниеТаблицы