API:FireDAC.Comp.Client.TFDCommand.CommandText

• Übergeordnet: TFDCommand

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):

• Extrahieren der Parameternamen und Füllen der Params-Kollektion, wenn ResourceOptions.ParamCreate True ist.
• Extrahieren des Makronamens und Füllen der Macros-Kollektion, wenn ResourceOptions.MacroCreate True ist.
• Extrahieren des FROM-Tabellennamens für SELECT-Anweisungen und Zuweisen des Namens zu CommandIntf.SourceObjectName, wenn ResourceOptions.PreprocessCmdText True ist.
• Füllen des Wertes der Eigenschaft CommandKind, wenn sie nicht explizit gesetzt ist.

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

• Vorverarbeiten von Anweisungstext
• Ausführen von Anweisungen
• FireDAC.Stan.Option.TFDResourceOptions.ParamCreate
• FireDAC.Stan.Option.TFDResourceOptions.MacroCreate
• FireDAC.Stan.Option.TFDResourceOptions.PreprocessCmdText
• FireDAC.Comp.Client.TFDCustomCommand.CommandKind
• FireDAC.Comp.Client.TFDCustomCommand.Params
• FireDAC.Comp.Client.TFDCustomCommand.Macros
• FireDAC.Comp.Client.TFDCustomCommand.ResourceOptions