FireDAC.Comp.Client.TFDCustomCommand.Prepared

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

property Prepared: Boolean read GetPrepared write SetPrepared stored IsPS default False;

C++

__property bool Prepared = {read=GetPrepared, write=SetPrepared, stored=IsPS, default=0};

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
property public
FireDAC.Comp.Client.pas
FireDAC.Comp.Client.hpp
FireDAC.Comp.Client TFDCustomCommand

Beschreibung

Ermittelt oder setzt die Anweisung für den Ausführungsstatus.

Setzen Sie Prepare auf True, um die SQL-Anweisung für die Ausführung vorzubereiten. Danach hat State den Wert csPrepared. Durch Setzen von Prepared auf True wird die Methode Prepare aufgerufen. Prepared muss für eine Standard-SQL-Anweisung nicht vor der Ausführung auf True gesetzt werden, weil der erste Aufruf von Execute/Open die Anweisung automatisch vorbereitet. Für gespeicherte Prozeduren muss die Methode aufgerufen werden, wenn die Kollektion Params 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 die DBMS-Verbindung aktiv sein, ansonsten wird eine Exception ausgelöst.

Nach der Vorbereitung der SQL-Anweisung können die Parameterdatentypen und -größen der Anweisung in der Anwendung nicht geändert werden, ansonsten wird beim nächsten Aufruf von Execute oder Open eine Exception ausgelöst. Legen Sie daher die Parameter vor dem Setzen von Prepared auf True fest.

Setzen Sie Prepared auf False, um die Vorbereitung der SQL-Anweisung aufzuheben und alle Ressourcen freizugeben. Danach hat State den Wert csInactive. Durch Setzen von Prepared auf False wird die Methode Unprepare aufgerufen.

Siehe auch