Функция SQLEXEC( )

Посылает оператор SQL в источник данных, где этот оператор подвергается обра отке.

Синтаксис

SQLEXEC(nConnectionHandle, cSQLCommand, [CursorName])

Параметры

nConnectionHandle

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

cSQLCommand

Задает оператор SQL, передаваемый в источник данных.

Конструкция SQL может содержать предложение WHERE, которое создает парамет изованное представление. Все параметры в предложении WHERE должны быть определены о выдачи функции SQLEXEC( ). Например, если параметрами являются переменные памяти, они должны быть созданы и проинициализированы до выдачи SQLEXEC( ). Подро нее о создании параметризованных представлений см. главу 8 "Создание многотаб ичных представлений" Руководства разработчика.

CursorName

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

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

Результат

Числовой

Комментарии

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

Если оператор SQL генерирует ровно одно результирующее множество, функция SQLEXEC( ) сохраняет это множество в заданном курсоре Visual FoxPro. Если оператор SQL генерирует несколько результирующих множеств и значение свойства BatchMode установлено функцией SQLSETPROP( ) равным 1 (пакетный режим), Вы можете п исвоить имя каждому результирующему множеству, установив опцию BatchMode равной 0 и изменяя имя курсора при каждом вызове функции SQLMORERESULTS( ).

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