Хранит имена таблиц источника данных к курсору Visual FoxPro. 

SQLTABLES(nStatementHandle [, cTableTypes] [, cCursorName])

Параметры

nStatementHandle

Определяет дескриптор источника данных, который возвращен функцией SQLCONNECT( ).
cTableTypes

Определяет один или более типов таблицы. Допустимые типы таблицы - 'TABLE, ' 'VIEW, ' 'SYSTEM TABLE, ' или идентифкатор любого допустимого табличного типа в качестве источника данных. Если Вы включаете список типов таблиц, разделите типы таблиц запятыми. Все имена таблиц в источнике данных являются выбранными, если Вы опускаете cTableTypes или если cTableTypes является пустой строкой. Тип таблицы, который Вы определяете, должен быть ограничен одиночными кавычками. Следующий пример демонстрирует, как задать типы таблиц 'VIEW' и 'SYSTEM TABLE' в виде символьной строки.
Скопировать код 
? SQLTABLES(handle, "'VIEW', 'SYSTEM TABLE'", "mydbresult")
cCursorName

Определяет имя курсора Visual FoxPro, которому посылают результат. Если Вы не включаете имя курсора, Visual FoxPro использует заданное по умолчанию имя SQLRESULT. Структура результатов зависит от внутренней функции SQLTABLES( ) для хэндлера ODBC.

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

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

Замечания

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

Пример

Следующий пример допускает доступным источник данных ODBC по имени MyFoxSQLNT. Используется SQLCONNECT( ), его возвращаемое значение сохраняется в переменной по имени gnHandle .

Если Вы не можете соединиться с источником данных, SQLCONNECT( ) возвращает отрицательное число и выводит сообщение.

Если Вы успешно соединяетесь с источником данных, SQLCONNECT( ) возвращает положительное число и выводит диалог. SQLTABLES( ) используется, чтобы создать курсор, по имени mycursor который содержит информацию о таблицах в источнике данных. LIST используется, чтобы вывести информацию о таблицах.

Скопировать код 
STORE SQLCONNECT('MyFoxSQLNT', '<userid>', '<password>') TO gnConnHandle
IF gnConnHandle < 0
   = MESSAGEBOX('Cannot make connection', 16, 'SQL Connect Error')
ELSE
   = MESSAGEBOX('Connection made', 48, 'SQL Connect Message')
   STORE SQLTABLES(gnConnHandle, 'TABLE', 'mycursor') TO nTables
   IF nTables = 1
      SELECT mycursor
      LIST
   ENDIF
ENDIF

См. Также