SQLPREPARE( )-Funktion
Bereitet eine SQL-Anweisung für die Remoteausführung durch SQLEXEC( ) vor.
SQLPREPARE(nConnectionHandle, cSQLCommand, [cCursorName])
Rückgabewerte
Numerisch
Parameter
nConnectionHandle
Gibt das Verbindungshandle der Datenquelle an, das von SQLCONNECT( ) zurückgegeben wird.cSQLCommand
Gibt die an die Datenquelle übergebene SQL-Anweisung an.Die SQL-Anweisung kann eine parametrisierte WHERE-Klausel enthalten, die eine Ansicht mit Parametern erstellt. Vor der Eingabe von SQLPREPARE( ) müssen alle Parameter der WHERE-Klausel definiert werden. Handelt es sich bei den Parametern beispielsweise um Variablen, müssen diese Variablen vor der Eingabe von SQLPREPARE( ) erstellt und initialisiert werden.
Weitere Informationen zum Erstellen von parametrisierten Ansichten finden Sie unter Erstellen von Ansichten.
cCursorName
Gibt den Namen des Visual FoxPro-Cursors an, an den das Resultset gesendet wird. Wenn Sie keinen Cursornamen angeben, verwendet Visual FoxPro den Standardnamen SQLRESULT.Bei mehreren Resultsets werden neue Cursornamen durch Anhängen einer erhöhten Zahl an den Namen des ersten Cursors erstellt.
Hinweise
SQLPREPARE( ) sendet die SQL-Anweisung an die Datenquelle. Dort wird die Anweisung zur schnelleren Ausführung kompiliert. Nach dem Kompilieren kann die SQL-Anweisung mit SQLEXEC( ) ausgeführt werden. Wenn mit SQLEXEC( ) eine mit SQLPREPARE( ) vorbereitete SQL-Anweisung ausgeführt wird, ist in SQLEXEC( ) lediglich das Verbindungshandle erforderlich.
Beispiel
gcAuthor = 'Smith'
= SQLPREPARE(gnConnHandle, 'SELECT * FROM authors; WHERE au_lname = ?gcAuthor')
= SQLEXEC(gnConnHandle)
...
gcAuthor = 'Jones'
= SQLEXEC(gnConnHandle)