Функция ADBOBJECTS( )

Помещает в массив переменных памяти имена соединений, отношений, таблиц или п едставлений SQL из текущей базы данных.

Синтаксис

ADBOBJECTS(ArrayName, cSetting)

Параметры

ArrayName

Задает имя массива, в который заносятся имена. Если задано имя несуществующего массива, Visual FoxPro автоматически создает такой массив. Если задано имя существующего массива, который не в состоянии вместить все имена, Visual FoxPro автоматически увеличивает размер массива надлежащим образом. Если в массиве бо ьше элементов, чем необходимо, Visual FoxPro укорачивает его. Если массив уже существует и функция ADBOBJECTS( ) возвращает 0, не найдя соответствующих имен, то массив не изменяется. Если массив не существует и ADBOBJECTS( ) возвращает 0, массив не создается.

Массив размерности 1 создается, когда вы указываете в качестве значения cSetting CONNECTION, TABLE или VIEW. Каждая строка в массиве размерности 1 содержит имя соединения, таблицы или вида в базе данных.

Массив размерности 2 создается, когда вы указываете в качестве значения cSetting RELATION. Каждая строка массива размерности 2 отвечает за реляцию в базе данн х. Первый столбец массива содержит имя дочерней таблицы, а второй имя родите ьской таблицы. Третий столбец содержит имя тега индекса для дочерней таблицы, а четвертый имя тега для родительской.

Пятый столбец массива содержит информацию по согласованию ссылок. Этот столбец пуст, если реляция не имеет правил согласования ссылок. Если же реляция обла ает правилами согласования ссылок, столбец содержит символы, соответствующие типам правил согласования ссылок для обновлений, удалений и вставок. Первый символ показывает тип правила обновления, второй тип правила удаления и третий тип правила вставки. Возможными значениями для правил обновления и удаления яв яются C для каскада, R для ограничения и I для игнорирования. Возможными значениями для вставок являются R для ограничения и I для игнорирования. Например, если еляция обладает каскадными обновлениями, ограниченными удаленьями и игнорируем ми правилами вставки для согласования ссылок, столбец содержит CRI.

cSetting

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

cSetting	Имена
CONNECTION	Имена соединений
RELATION	Отношения таблиц
TABLE	Имена таблиц
VIEW	Имена представлений

Ключевые слова CONNECTION, RELATION, TABLE и VIEW сокращать нельзя.

Результат

Числовой

Комментарии

В момент выдачи функции ADBOBJECTS( ) база данных должна быть открыта и должна использоваться в качестве текущей; в противном случае Visual FoxPro сгенери ует сообщение об ошибке.