Готовит инструкцию SQL к отдаленному выполнению SQLEXEC( ). 

SQLPREPARE(nStatementHandle, cSQLCommand, [cCursorName])

Параметры

nStatementHandle

Определяет дескриптор подключения к источнику данных, возвращаемому SQLCONNECT( ).
cSQLCommand

Определяет инструкцию SQL, передаваемую к источнику данных. Инструкция SQL может содержать параметризующее предложение WHERE, которое создает параметризованное представление. Все параметры в предложении WHERE должны быть определены, прежде чем SQLPREPARE( ) будет применена. Например, если параметры являются переменными, то они должны быть созданы и инициализированы прежде, чем SQLPREPARE( ) будет применена. Для подробной информации о параметризованных представлениях, см. Как: Создать Параметризованое представление .
cCursorName

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

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

Числовое

Замечания

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

Пример

Скопировать код 
gcAuthor = 'Smith'
= SQLPREPARE(gnHandle, 'SELECT * FROM authors;   WHERE au_lname = ?gcAuthor')
= SQLEXEC(gnHandle)
...
gcAuthor = 'Jones'
= SQLEXEC(gnHandle)

См. Также