Datasnap.Provider.TCustomProvider.Execute

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

procedure Execute(const CommandText: OleStr; var Params,  OwnerData: OleVariant); virtual;

C++

virtual void __fastcall Execute(const System::WideString CommandText, System::OleVariant &Params, System::OleVariant &OwnerData);

Propriétés

Type Visibilité  Source Unité  Parent
procedure
function
public
Datasnap.Provider.pas
Datasnap.Provider.hpp
Datasnap.Provider TCustomProvider

Description

Execute exécute une requête, une procédure stockée ou une instruction SQL personnalisée.

Les ensembles de données client appellent Execute par le biais de la méthode AS_Execute de l'interface IAppServer. En réponse, le fournisseur exécute une commande SQL. Si le fournisseur représente une requête ou procédure stockée ne renvoyant pas de curseur, l'appel à Execute amène le fournisseur à exécuter la requête ou la procédure stockée. Si l'appelant fournit une valeur pour CommandText, Execute peut exécuter cette instruction à la place (voir ci-après).

Avant d'exécuter la commande appropriée, Execute génère un événement BeforeExecute. Après avoir exécuté la commande, elle génère un événement AfterExecute. Enfin, elle renvoie tous les paramètres de sortie en tant que valeur du paramètre Params.

CommandText est une instruction SQL qui remplace le code SQL d'une requête associée, ou le nom d'une procédure stockée qui remplace la procédure stockée associée. Ce paramètre n'est pas pris en compte si la propriété Options ne contient pas poAllowCommandText.

En entrée, Params fournit les valeurs des paramètres de la requête, de la procédure stockée ou de la chaîne CommandText. En sortie, Params renvoie tous les paramètres de sortie.

OwnerData contient les informations personnalisées transmises au fournisseur à partir du gestionnaire d'événement BeforeExecute de l'ensemble de données client. Ces informations sont transmises au gestionnaire d'événement BeforeExecute du fournisseur puis renvoyées par le gestionnaire d'événement AfterExecute du fournisseur.

Voir aussi