FireDAC.Comp.Client.TFDRdbmsDataSet.Prepare

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure Prepare;

C++

void __fastcall Prepare();

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
procedure
function
public
FireDAC.Comp.Client.pas
FireDAC.Comp.Client.hpp
FireDAC.Comp.Client TFDRdbmsDataSet

Beschreibung

Bereitet die SQL-Anweisung für die Ausführung vor.

Mit der Methode Prepare bereiten Sie die SQL-Anweisung für die Ausführung vor. Bei einer Standard-SQL-Anweisung muss Prepare nicht vor der Ausführung aufgerufen werden, weil der erste Aufruf von Execute/ExecSQL/Open die Anweisung automatisch vorbereitet. Für gespeicherte Prozeduren muss diese Methode allerdings aufgerufen werden, wenn die Params-Kollektion automatisch gefüllt werden soll. Nach Vorbereitung der Anweisung gibt SQLText den SQL-Anweisungstext so zurück, wie er an das DBMS gesendet wird.

Zur Vorbereitung der SQL-Anweisung muss eine DBMS-Verbindung aktiv sein; ansonsten wird eine Exception ausgelöst.

Nach dem Aufruf von Prepare können die Parameterdatentypen und -größen der Anweisung in der Anwendung nicht geändert werden. Ansonsten wird beim nächsten Aufruf von Execute/ExecSQL/ExecProc/Open eine Exception ausgelöst. Legen Sie die Parameter vor dem Aufruf von Prepare fest.

Beispiel

 
 FDQuery1.SQL.Text := 'select * from MyTab';
 FDQuery1.Prepare;

Siehe auch