JavaScript Editor js editor     Web development 



Main Page

Prepares a SQL statement for remote execution by SQLEXEC(В ).

SQLPREPARE(nStatementHandle, cSQLCommand, [cCursorName])

Parameters

nStatementHandle


Specifies the statement handle to the data source returned by SQLCONNECT(В ).
cSQLCommand


Specifies the SQL statement passed to the data source. The SQL statement can contain a parameterized WHERE clause, which creates a parameterized view. All parameters in the WHERE clause must be defined before SQLPREPARE(В ) is issued. For example, if the parameters are variables, the variables must be created and initialized before SQLPREPARE(В ) is issued. For more information about parameterized views, see How to: Create Parameterized Views.
cCursorName


Specifies the name of the Visual FoxPro cursor to which the result set is sent. If you don't include a cursor name, Visual FoxPro uses the default name SQLRESULT. For multiple result sets, new cursor names are derived by appending an incremented number to the name of the first cursor.

Return Value

Numeric

Remarks

SQLPREPARE(В ) sends the SQL statement to the data source where it is compiled for faster execution. After the SQL statement is compiled, it can be executed with SQLEXEC(В ). If SQLEXEC(В ) is used to execute a SQL statement prepared with SQLPREPARE(В ), only the statement handle is required in SQLEXEC(В ).

Example

В Copy Code
gcAuthor = 'Smith'
= SQLPREPARE(gnHandle, 'SELECT * FROM authors;   WHERE au_lname = ?gcAuthor')
= SQLEXEC(gnHandle)
...
gcAuthor = 'Jones'
= SQLEXEC(gnHandle)

See Also



JavaScript Editor js editor     Web development