Data.SqlExpr.TCustomSQLDataSet.CommandText

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

property CommandText: string read FCommandText write SetCommandText;

C++

__property System::UnicodeString CommandText = {read=FCommandText, write=SetCommandText};

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
property public
Data.SqlExpr.pas
Data.SqlExpr.hpp
Data.SqlExpr TCustomSQLDataSet

Beschreibung

Enthält die Anweisung, die von der Datenmenge ausgeführt wird.

Der Wert von CommandText hängt von der Eigenschaft CommandType wie folgt ab:

  • Wenn CommandType den Wert ctQuery enthält, dann ist CommandText eine SQL-Anweisung, die die Datenmenge ausführt.
    • Handelt es sich dabei um eine SELECT-Anweisung, wird die Ausführung gestartet, sobald die SQL-Datenmenge geöffnet wird.
    • Wenn die Anweisung keine Ergebnismenge zurückgibt, wird sie von der SQL-Datenmenge erst bei einem Aufruf der Methode ExecSQL ausgeführt.
  • Wenn CommandType den Wert ctStoredProc enthält, dann ist CommandText der Name einer Stored Procedure.
    • Die SQL-Datenmenge führt die Stored Procedure aus, wenn sie geöffnet oder die Methode ExecSQL aufgerufen wird. Die Art der Ausführung hängt davon ab, ob die Stored Procedure eine Ergebnismenge zurückgibt.
  • Wenn CommandType den Wert ctTable enthält, dann ist CommandText der Name einer Tabelle auf dem Datenbankserver.
    • Die SQL-Datenmenge generiert automatisch eine SELECT-Anweisung, die alle Datensätze und alle Felder der Tabelle abruft. Die Ergebnismenge ist nach den Feldern in der Eigenschaft SortFieldNames sortiert.
    • Die generierte Anweisung wird ausgeführt, sobald die Datenmenge geöffnet wird.

Mit der Eigenschaft Params stellen Sie die Parameterwerte bereit, wenn CommandText entweder eine SQL-Anweisung ist, die Parameter enthält, oder der Name einer Stored Procedure, die über Parameter verfügt.


Ein Beispiel für die Verwendung des CommandText-Feldes finden Sie unter Mobile-Tutorial: Verwenden von InterBase ToGo mit dbExpress (iOS und Android). In dem Tutorial wird gezeigt, wie das Feld CommandText mit einem String (Abfrage) gefüllt wird, anstatt den Anweisungstext-Editor zu verwenden, den Sie im Objektinspektor durch Doppelklicken auf die Ellipsen-Schaltfläche [...] im Wertefeld von CommandText öffnen können.

Siehe auch