API:FireDAC.Comp.Client.TFDCommand.Macros

De RAD Studio API Documentation
Aller à : navigation, rechercher

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.

FireDAC.Comp.Client.TFDCommand.Macros hérite de FireDAC.Comp.Client.TFDCustomCommand.Macros. Tout le contenu en-dessous de cette ligne se réfère à FireDAC.Comp.Client.TFDCustomCommand.Macros.

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 « http://docwiki.embarcadero.com/Libraries/Sydney/f/index.php?title=API:FireDAC.Comp.Client.TFDCommand.Macros&oldid=512746 »