Сохраняет список имен столбцов и информацию о каждом столбце для указанной таблицы источника данных в курсоре 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
Количество десятичных знаков
- 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') |
См. Также
Другие Ресурсы
AERROR( ) ФункцияSQLGETPROP( ) Функция
SQLSETPROP( ) Функция
SQLTABLES( ) Функция
SQL Команды и Функции
Справочник Языка