Datasnap.DSConnect.TDSProviderConnection.AS_Execute

De RAD Studio API Documentation
Aller à : navigation, rechercher


Delphi

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

C++

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

Propriétés

Type Visibilité  Source Unité  Parent
procedure
function
protected
Datasnap.DSConnect.pas
Datasnap.DSConnect.hpp
Datasnap.DSConnect TDSProviderConnection

Description

Exécute la requête ou la procédure stockée liée à un fournisseur spécifié.

Utilisez AS_Execute pour transmettre une commande d'exécution à un fournisseur distant, en utilisant un ensemble de paramètres spécifié. AS_Execute appelle la méthode AS_Execute du fournisseur spécifié après l'affectation de tout paramètre. 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 BeforeExecute, transmet la commande à son ensemble de données associé et génère un événement AfterExecute. 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 correctement 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 BeforeExecute et AfterExecute. Ces informations proviennent du gestionnaire d'événement BeforeExecute d'un ensemble de données client. La valeur renvoyée dans OwnerData est transmise au gestionnaire d'événement AfterExecute de l'ensemble de données client.

Voir aussi