Функция SQLCOLUMNS( )

Сохраняет в курсоре Visual FoxPro список имен столбцов заданной таблицы источ ика данных и информацию об этих столбцах.

Синтаксис

SQLCOLUMNS(nConnectionHandle, TableName
[, FOXPRO | NATIVE] [, CursorName])

Параметры

nConnectionHandle

Номер активного соединения.

TableName

Задает имя удаленной таблицы, из которой будут возвращены имена столбцов.

FOXPRO | NATIVE

Задает формат информации о столбцах, используемый в результирующем множестве. Не забудьте заключить FOXPRO или NATIVE в кавычки. Опция NATIVE определяет сох анение информации о столбцах таблиц в том же формате, что и в источнике данных. Опция FOXPRO сохраняет информацию о столбцах в том же формате, который испо ьзовался бы при создании таблицы или курсора Visual FoxPro в случае импортирова ия таблицы источника данных в Visual FoxPro. Если опустить и FOXPRO, и NATIVE, по умолчанию принимается формат FOXPRO.

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

Имя столбца	Описание
Field_name	Имя столбца
Field_type	Тип данных столбца
Field_len	Длина столбца
Field_dec	Число десятичных позиций

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

Имя столбца	Описание
Table_qualifier	Идентификатор описателя таблицы
Table_owner	Идентификатор владельца таблицы
Table_name	Идентификатор таблицы
Column_name	Идентификатор столбца
Data_type	Тип данных столбца
Type_name	Имя типа данных столбца
Precision	Точность столбца
Length	Размер передаваемых данных
Scale	Масштаб столбца
Radix	Основание системы счисления для данных числового типа
Nullable	Поддержка значений NULL
Remarks	Описание столбца

Если таблицы TableName не существует и установлен формат NATIVE, функция SQLCOLUMNS( ) возвращает з ачение "истина" (.T.) и создает пустую таблицу или курсор. Если таблицы TableName не существует и установлен формат FOXPRO, функция SQLCOLUMNS( ) возвращает " ожь" (.F.).

CursorName

Задает имя курсора Visual FoxPro для результирующего множества. Если имя курсо а не указано, Visual FoxPro использует стандартное имя SQLRESULT.

Результат

Числовой

Комментарии

Функция SQLCOLUMNS( ) возвращает 1, если курсор создан успешно, 0, если SQLCOLUMNS( ) продолжает выполняться, 1 в случае ошибки уровня соединения и 2 в случае ошибки уровня среды выполнения.

SQLCOLUMNS( ) является одной из четырех функций, которые можно выполнять либо синхронно, либо асинхронно. Конкретный режим работы определяется значением свойства Asynchronous, устанавливаемым функцией SQLSETPROP( ). В асинхронном режиме приходится повторно вызывать функцию SQLCOLUMNS( ) до тех пор, пока не будет возвращено значение, отличное от 0, что соответствует продолжению выполнения.