SQLPREPARE( ) (Función)
Prepara una instrucción SQL para su ejecución remota mediante SQLEXEC( ).
SQLPREPARE(nConnectionHandle, cSQLCommand, [cCursorName])
Valores devueltos
Numeric
Parámetros
nConnectionHandle
Especifica el identificador de conexión al origen de datos devuelto por SQLCONNECT( ).cSQLCommand
Especifica la instrucción SQL transferida al origen de datos.La instrucción SQL puede contener una cláusula WHERE parametrizada, que crea una vista parametrizada. Es necesario que estén definidos todos los parámetros de la cláusula WHERE antes de ejecutar SQLPREPARE( ). Por ejemplo, si los parámetros son variables, será necesario crearlas e inicializarlas antes de ejecutar SQLPREPARE( ).
Para obtener información adicional acerca de cómo crear vistas parametrizadas, vea Crear vistas.
cCursorName
Especifica el nombre del cursor de Visual FoxPro al que se envía el conjunto de resultados. Si no incluye un nombre de cursor, Visual FoxPro utilizará el nombre predeterminado SQLRESULT.Para varios conjuntos de resultados, se obtienen nuevos nombres de cursor agregando al nombre del primer cursor un número incrementado.
Observaciones
SQLPREPARE( ) envía la instrucción SQL al origen de datos, donde se compila para lograr una ejecución más rápida. Una vez compilada la instrucción SQL, puede ejecutarse con SQLEXEC( ). Si se utiliza SQLEXEC( ) para ejecutar una instrucción SQL preparada con SQLPREPARE( ), sólo se necesitará el identificador de conexión en SQLEXEC( ).
Ejemplo
gcAuthor = 'Smith'
= SQLPREPARE(gnConnHandle, 'SELECT * FROM authors; WHERE au_lname = ?gcAuthor')
= SQLEXEC(gnConnHandle)
...
gcAuthor = 'Jones'
= SQLEXEC(gnConnHandle)