Data.SqlExpr.TSQLConnection.Execute
Delphi
function Execute(const SQL: string; Params: TParams): Integer; overload;
function Execute(const SQL: string; Params: TParams; var ResultSet: TDataSet): Integer; overload;
function Execute(const SQL: string; Params: TParams; ResultSet: Pointer): Integer; overload; deprecated 'Use overloaded method instead';
C++
int __fastcall Execute(const System::UnicodeString SQL, Data::Db::TParams* Params)/* overload */;
int __fastcall Execute(const System::UnicodeString SQL, Data::Db::TParams* Params, Data::Db::TDataSet* &ResultSet)/* overload */;
int __fastcall Execute _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (const System::UnicodeString SQL, Data::Db::TParams* Params, void * ResultSet)/* overload */;
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | public | Data.SqlExpr.pas Data.SqlExpr.hpp |
Data.SqlExpr | TSQLConnection |
Description
Execute exécute une commande SQL sur le serveur.
Appelez Execute pour exécuter une seule commande sur le serveur sans devoir utiliser un ensemble de données SQL. La fonction Execute est particulièrement utile pour les instructions qui ne renvoient aucun ensemble de résultats, par exemple les instructions du langage de définition de données (DLL, Data Definition Language).
SQL est la commande à exécuter.
Params est un objet TParams qui contient tous les paramètres utilisés par l'instruction SQL. La liaison des paramètres est réalisée uniquement d'après les index (pas par nom), de sorte que l'ordre des paramètres est important. L'ordre des objets TParam dans Params correspond à l'ordre des paramètres dans l'instruction SQL. Utilisez les propriétés et les méthodes de TParams pour créer un objet Tparams, ajouter des objets TParam pour chaque paramètre et affecter des propriétés de paramètre telles que le type de données et la valeur. Si l'instruction SQL ne comprend aucun paramètre, transmettez une valeur nil (Delphi) ou NULL (C++) pour Params.
ResultSet est un pointeur sur une variable de type TCustomSQLDataSet*. Si l'instruction SQL renvoie un curseur, Execute crée une instance de TCustomSQLDataSet et la remplit avec l'ensemble de résultats. La nouvelle référence TCustomSQLDataSet est renvoyée comme la valeur sur laquelle ResultSet pointe. Si l'instruction SQL ne renvoie pas d'ensemble de résultats, transmettez une valeur nil (Delphi) ou NULL (C++) pour ResultSet. TPSResult est défini sur Pointer pour le code natif et sur TObject pour le code managé.
Execute renvoie le nombre d'enregistrements affectés par l'exécution de l'instruction SQL.
Conseil : Si l'instruction SQL ne comprend aucun paramètre, vous pouvez utiliser la méthode ExecuteDirect à la place.