FireDAC.Comp.Client.TFDCustomCommand.Macros
Delphi
property Macros: TFDMacros read FMacros write SetMacros stored False;
C++
__property Firedac::Stan::Param::TFDMacros* Macros = {read=FMacros, write=SetMacros, stored=false};
Inhaltsverzeichnis
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| property | public | FireDAC.Comp.Client.pas FireDAC.Comp.Client.hpp |
FireDAC.Comp.Client | TFDCustomCommand |
Beschreibung
Die Kollektion der Substitutionsvariablen eines Makros.
Die Eigenschaft Macros ist die Kollektion der Substitutionsvariablen eines Makros. Sie wird automatisch nach dem Zuweisen von CommandText gefüllt, wenn ResourceOptions.MacroCreate True ist. Ansonsten kann sie manuell gefüllt werden.
Beim Aufruf von Prepare werden die Makrowerte im CommandText ersetzt, wenn ResourceOptions.MacroExpand True ist.
Beispiel
//Example 1 - Substitute table name:
ADCommand1.CommandText.Text := 'select * from &Tab';
ADCommand1.Macros[0].AsIdentifier := 'Order Details';
ADCommand1.Prepare;
ShowMessage(ADCommand1.SQLText); // select * from "Order Details"
//Example 2 - Substitute WHERE condition:
ADCommand1.CommandText.Text := 'select * from MyTab {if !cond} where !cond {fi}';
ADCommand1.Macros[0].AsString := 'ID > 100';
ADCommand1.Prepare;
ShowMessage(ADCommand1.SQLText); // select * from MyTab where ID > 100
ADCommand1.Macros[0].Clear;
ADCommand1.Prepare;
ShowMessage(ADCommand1.SQLText); // select * from MyTab