FireDAC.Comp.Client.TFDCustomCommand.Prepare

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

procedure Prepare(const ACommandText: String = '');

C++

void __fastcall Prepare(const System::UnicodeString ACommandText = System::UnicodeString());

Propriétés

Type Visibilité  Source Unité  Parent
procedure
function
public
FireDAC.Comp.Client.pas
FireDAC.Comp.Client.hpp
FireDAC.Comp.Client TFDCustomCommand

Description

Prépare la commande SQL pour l'exécution.

Appelez la méthode Prepare pour préparer la commande SQL pour l'exécution. Après cela, la valeur de State devient csPrepared. Il n'est pas nécessaire d'appeler Prepare pour une commande SQL standard avant l'exécution, car le premier Execute / Open prépare automatiquement la commande. A la place, c'est nécessaire pour les procédures stockées, si vous devez remplir automatiquement la collection Params. Quand la commande est préparée, SQLText renvoie le texte de la commande SQL comme il est envoyé au SGBD.

Pour préparer la commande SQL, la connexion SGBD doit être active. Sinon, une exception est déclenchée.

Après la préparation, l'appel de l'application ne peut pas changer les types de données et les tailles des paramètres de la commande. Sinon, au prochain appel de Execute ou Open, une exception est déclenchée.

Remarque : Configurez les paramètres avant l'appel de Prepare.

Exemple

 ADCommand1.Prepare('select * from MyTab');

Voir aussi