FireDAC.Comp.Client.TFDCommand.Macros

De RAD Studio API Documentation

Delphi 

property Macros: TFDMacros read FMacros write SetMacros stored False;

C++ 

__property Macros;

Propriétés

Type Visibilité  Source Unité  Parent
property published
FireDAC.Comp.Client.pas
FireDAC.Comp.Client.hpp
 FireDAC.Comp.Client TFDCommand

Description

La collection des variables de substitution d'une macro. {{#multireplace:FireDAC.Comp.Client.TFDCommand.Macros|H21=!|H25=%|H28=(|H29=)|H2A=*|H2B=+|H2F=/|H3C=<|H3D==|H3E=>|H5B=[|H5D=]|H5E=^|H7C=|}} hérite de {{#multireplace:FireDAC.Comp.Client.TFDCustomCommand.Macros|H21=!|H25=%|H28=(|H29=)|H2A=*|H2B=+|H2F=/|H3C=<|H3D==|H3E=>|H5B=[|H5D=]|H5E=^|H7C=|}}. Tout le contenu en-dessous de cette ligne se réfère à {{#multireplace:FireDAC.Comp.Client.TFDCustomCommand.Macros|H21=!|H25=%|H28=(|H29=)|H2A=*|H2B=+|H2F=/|H3C=<|H3D==|H3E=>|H5B=[|H5D=]|H5E=^|H7C=|}}.

La collection des variables de substitution d'une macro.

La propriété Macros est la collection des variables de substitution d'une macro. Elle est remplie automatiquement après l'affectation de CommandText, si ResourceOptions.MacroCreate a la valeur True. Sinon, elle peut être remplie manuellement.

Lors de l'appel de Prepare, les valeurs des macros sont substituées dans CommandText, si ResourceOptions.MacroExpand a la valeur True.

Exemple

 
 //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

Voir aussi

Récupérée de « https://docwiki.embarcadero.com/Libraries/Rio/f/index.php?title=FireDAC.Comp.Client.TFDCommand.Macros&oldid=512747 »