API:FireDAC.Comp.Client.TFDCommand.CommandText

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

property CommandText: TStrings read FCommandText write SetCommandTextStrs;

C++

__property CommandText;

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
property published
FireDAC.Comp.Client.pas
FireDAC.Comp.Client.hpp
FireDAC.Comp.Client TFDCommand

Beschreibung

Der Text der auszuführenden SQL-Anweisung.

FireDAC.Comp.Client.TFDCommand.CommandText erbt von FireDAC.Comp.Client.TFDCustomCommand.CommandText. Der folgende Inhalt bezieht sich auf FireDAC.Comp.Client.TFDCustomCommand.CommandText.

Der Text der auszuführenden SQL-Anweisung.

Die Eigenschaft CommandText setzt/ermittelt:

  • Den Text der auszuführenden SQL-Anweisung.
  • Den Namen der auszuführenden gespeicherten Prozedur, wenn CommandKind in [skStoredProc, skStoredProcWithCrs, skStoredProcNoCrs] enthalten ist.

Nach dem Setzen von CommandText führt FireDAC die folgenden Aktionen aus (nicht für gespeicherte Prozeduren):

Wenn Sie mit der Methode CommandText.Add eine lange Anweisung hinzufügen, dann sollten Sie CommandText.BeginUpdate vor der Anweisungsänderung und CommandText.EndUpdate nach Abschluss der Anweisungsänderung aufrufen.

Später, wenn Prepare aufgerufen wird, wird der Anweisungstext vorverarbeitet und in eine Ziel-DBMS-Anweisung umgewandelt. Details über FireDAC-Makros und -Escape-Sequenzen (Präprozessor-Anweisungen) finden Sie im Kapitel Vorverarbeiten von Anweisungstext.

Siehe auch