Soap.SOAPDm.TSoapDataModule.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
Soap.SOAPDm.pas
Soap.SOAPDm.hpp
Soap.SOAPDm TSoapDataModule


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.

Remarque :  N'appelez AS_AS_Execute que pour un fournisseur dont l'ensemble de données représente 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 du fournisseur ou le nom d'une procédure stockée qui remplace la procédure stockée sous-jacente du fournisseur. Ce paramètre n'est pas pris en compte si la propriété Options 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 méthode PackageParams.

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.

Remarque :  Les applications ne peuvent appeler la méthode protégée AS_AS_Execute qu'à l'aide de l'interface IAppServer. Pour exécuter un ensemble de données dans du code à partir du serveur d'applications, utilisez le composant ensemble de données directement.

Voir aussi