Data.SqlExpr.TCustomSQLDataSet.PSExecuteStatement

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function PSExecuteStatement(const ASQL: string; AParams: TParams): Integer; overload; override;
function PSExecuteStatement(const ASQL: string; AParams: TParams;  var ResultSet: TDataSet): Integer; overload; override;
function PSExecuteStatement(const ASQL: string; AParams: TParams;  ResultSet: Pointer = nil): Integer; overload; override; deprecated 'Use overloaded method instead';

C++

virtual int __fastcall PSExecuteStatement(const System::UnicodeString ASQL, Data::Db::TParams* AParams)/* overload */;
virtual int __fastcall PSExecuteStatement(const System::UnicodeString ASQL, Data::Db::TParams* AParams, Data::Db::TDataSet* &ResultSet)/* overload */;
virtual int __fastcall PSExecuteStatement _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (const System::UnicodeString ASQL, Data::Db::TParams* AParams, void * ResultSet = (void *)(0x0))/* overload */;

Propriétés

Type Visibilité  Source Unité  Parent
function protected
Data.SqlExpr.pas
Data.SqlExpr.hpp
Data.SqlExpr TCustomSQLDataSet

Description

Exécute la commande SQL spécifiée.

Data.SqlExpr.TCustomSQLDataSet.PSExecuteStatement hérite de Data.DB.TDataSet.PSExecuteStatement. Tout le contenu en-dessous de cette ligne se réfère à Data.DB.TDataSet.PSExecuteStatement.

Exécute la commande SQL spécifiée.

Si la valeur de la propriété ResolveToDataSet est False, un composant fournisseur appelle (indirectement) PSExecuteStatement pour exécuter les instructions SQL qu'il génère pour appliquer les mises à jour. Généralement, l'ensemble de données transmet ces instructions au serveur de bases de données pour qu'il les exécute.

Le paramètre ASQL spécifie la commande SQL à exécuter.

AParams contient les valeurs de paramètre à appliquer à ASQL avant l'exécution.

ResultSet permet à PSExecuteStatement de renvoyer un composant ensemble de données contenant le résultat d'une instruction SELECT. Si ResultSet n'a pas la valeur nil (Delphi) ou NULL (C++), PSExecuteStatement crée un nouveau composant ensemble de données comme destination de ce pointeur et le remplit avec l'ensemble de résultats. L'appelant est responsable de la libération de l'ensemble de données.

Cette méthode est une implémentation de la méthode IProviderSupport.PSExecuteStatement. Par défaut, elle renvoie 0. Pour l’utiliser, chaque descendant de TDataSet doit la redéfinir d'une manière spécifique.

PSExecuteStatement renvoie le nombre de lignes assignées par l'exécution de ASQL.

Voir aussi