Datasnap.Midas.IAppServer.AS_Execute

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

procedure AS_Execute(const ProviderName: OleStr; const CommandText: OleStr;  var Params: OleVariant; var OwnerData: OleVariant); safecall;

C++

virtual HRESULT __safecall AS_Execute(const System::WideString ProviderName, const System::WideString CommandText, System::OleVariant &Params, System::OleVariant &OwnerData) = 0 ;

Propriétés

Type Visibilité  Source Unité  Parent
procedure
function
public
Datasnap.Midas.pas
Datasnap.Midas.hpp
Datasnap.Midas IAppServer


Description

AS_Execute exécute la requête ou la procédure stockée liée au fournisseur spécifié.

Appelez la méthode AS_AS_Execute pour transmettre une commande à exécuter au fournisseur distant en utilisant l'ensemble de paramètres spécifié. AS_AS_Execute appelle la méthode AS_Execute du fournisseur spécifié après avoir initialisé tous les paramètres. Les paramètres en sortie résultant de l'exécution d'une requête ou d'une procédure stockée sont renvoyés dans le paramètre Params.

La méthode AS_Execute du fournisseur génère un événement BeforeAS_Execute, transmet la commande à son ensemble de données associé et génère un événement AfterAS_Execute. L'ensemble de données doit représenter une requête ou procédure stockée qui ne renvoie pas de curseur.

Le paramètre ProviderName spécifie le nom du composant fournisseur associé à la requête ou la procédure stockée.

CommandText spécifie une instruction SQL optionnelle qui remplace le SQL de la requête ou le nom d'une procédure stockée qui remplace la procédure stockée de l'ensemble de données. Ce paramètre n'est pas pris en compte si la propriété Options du fournisseur ne contient pas poAllowCommandText.

Le paramètre Params code tous les paramètres attendus par la requête ou la procédure stockée et renvoie les paramètres en sortie. Pour créer une valeur de propriété codée pour Params à partir d'un objet TParams, utilisez la routine PackageParams. Pour décoder Params en un objet TParams, utilisez la routine Unpackparams.

Le paramètre OwnerData contient des informations personnalisées qui apparaissent comme un argument des gestionnaires d'événement BeforeAS_Execute et AfterAS_Execute du fournisseur. Ces informations proviennent du gestionnaire d'événement BeforeAS_Execute d'un ensemble de données client. La valeur renvoyée dans OwnerData est transmise au gestionnaire d'événement AfterAS_Execute de l'ensemble de données client.

Voir aussi