FireDAC.Comp.Client.TFDRdbmsDataSet.Prepared

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

property Prepared: Boolean read GetPrepared write SetPrepared stored IsPS default False;

C++

__property bool Prepared = {read=GetPrepared, write=SetPrepared, stored=IsPS, default=0};

Propriétés

Type Visibilité  Source Unité  Parent
property public
FireDAC.Comp.Client.pas
FireDAC.Comp.Client.hpp
FireDAC.Comp.Client TFDRdbmsDataSet

Description

Obtient ou définit la préparation d'une commande pour le statut d'exécution.

Définissez Prepared sur True pour préparer la commande SQL pour l'exécution. La définition de Prepared sur True appellera la méthode Prepare. Il n'est pas nécessaire de définir Prepared sur True pour une commande SQL standard avant l'exécution, car le premier appel de Execute / ExecSQL / Open préparera automatiquement la commande prepare. Mais elle est requise pour les procédures stockées, si vous devez remplir automatiquement la collection Params. Quand la commande est préparée, SQLText renverra le texte de la commande SQL comme il est envoyé au SGBD.

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

Après la préparation de la commande SQL, l'application ne peut pas changer les tailles et les types de données des paramètres de la commande, sinon à l'appel de Execute ou Open suivant, une exception sera déclenchée. Ainsi, configurez les paramètres avant de définir Prepared sur True.

Définissez Prepared sur False pour annuler la préparation de la commande SQL et libérer toutes ses ressources. La définition de Prepared sur False, appellera la méthode Unprepare.

Voir aussi