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

SQLCOLUMNS(nStatementHandle, cTableName
    [, "FOXPRO" | "NATIVE"] [, cCursorName])

Параметры

nStatementHandle

Определяет активный дескриптор состояния.
cTableName

Определяет имя таблицы, из которой возращаяются имена столбцов. TableName может содержать групповые символы ? и *. Вопросительный знак (?) соответствует любому единственному символу, и звездочка (*) соответствует любому числу символов.
FOXPRO | NATIVE

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

Имя столбца Описание

Field_name

Имя столбца

Field_type

Тип данных столбца

Field_len

Длина столбца

Field_dec

Количество десятичных знаков

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

Определяет имя курсора Visual FoxPro для выводов результатов. Если Вы не включаете имя курсора, Visual FoxPro использует заданное по умолчанию имя SQLRESULT.

Возвращаемое значение

Числовой или Логическое. SQLCOLUMNS( ) возвращает 1, если курсор успешно создан, 0 если SQLCOLUMNS( ) все еще выполняется, - 1, если происходит ошибка уровня подключения, и - 2, если происходит ошибка уровня среды.

Замечания

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

Пример

Следующий пример допупскает что SQLCONNECT( ) успешно запущена, и её возвращаемое значение сохранено в переменной памяти, которую именуют gnHandle . SQLCOLUMNS( ) используется, чтобы создать курсор MyCursor содержащий информации о столбцах таблицы authors .

Скопировать код 
= SQLCOLUMNS(gnHandle, 'authors', 'FOXPRO', 'MyCursor')

См. Также