Data.SqlExpr.TSQLDataSet.CommandText
Delphi
property CommandText: string read FCommandText write SetCommandText default 0;
C++
__property CommandText = {default=0};
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| property | published | Data.SqlExpr.pas Data.SqlExpr.hpp |
Data.SqlExpr | TSQLDataSet |
Beschreibung
Enthält die Anweisung, die von der Datenmenge ausgeführt wird. {{#multireplace:Data.SqlExpr.TSQLDataSet.CommandText|H21=!|H25=%|H28=(|H29=)|H2A=*|H2B=+|H2F=/|H3C=<|H3D==|H3E=>|H5B=[|H5D=]|H5E=^|H7C=|}} erbt von {{#multireplace:Data.SqlExpr.TCustomSQLDataSet.CommandText|H21=!|H25=%|H28=(|H29=)|H2A=*|H2B=+|H2F=/|H3C=<|H3D==|H3E=>|H5B=[|H5D=]|H5E=^|H7C=|}}. Der folgende Inhalt bezieht sich auf {{#multireplace:Data.SqlExpr.TCustomSQLDataSet.CommandText|H21=!|H25=%|H28=(|H29=)|H2A=*|H2B=+|H2F=/|H3C=<|H3D==|H3E=>|H5B=[|H5D=]|H5E=^|H7C=|}}.
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.