Data.DB.TDataSet.PSExecuteStatement
| [–] Properties | |
|---|---|
| Type: function | |
| Visibility: protected | |
| Source: Data.DB.pas Data.DB.hpp
| |
| Unit: Data.DB | |
| Parent: TDataSet | |
Delphi
function PSExecuteStatement(const ASQL: string; AParams: TParams): Integer; overload; virtual;
function PSExecuteStatement(const ASQL: string; AParams: TParams;
var ResultSet: TDataSet): Integer; overload; virtual;
function PSExecuteStatement(const ASQL: string; AParams: TParams;
ResultSet: Pointer): Integer; overload; virtual; deprecated 'Use overloaded method instead';
C++
virtual int __fastcall PSExecuteStatement(const System::UnicodeString ASQL, TParams* AParams)/* overload */;
virtual int __fastcall PSExecuteStatement(const System::UnicodeString ASQL, TParams* AParams, TDataSet* &ResultSet)/* overload */;
virtual int __fastcall PSExecuteStatement _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (const System::UnicodeString ASQL, TParams* AParams, void * ResultSet)/* overload */;
Description
Executes a specified SQL command.
If the value of ResolveToDataSet property is False, a provider component calls PSExecuteStatement (indirectly) to execute SQL statements that it generates for applying updates. Usually, the dataset passes these statements on to its database server for execution.
The ASQL parameter specifies the SQL command to execute.
AParams contains any parameter values that should be applied to ASQL before execution.
ResultSet allows PSExecuteStatement to return a dataset component that contains the results of a SELECT statement. If ResultSet is not nil (Delphi) or NULL (C++), PSExecuteStatement creates a new dataset component as the target of this pointer and fills it with the result set. The caller is responsible for freeing the dataset.
This method is an implementation of IProviderSupport.PSExecuteStatement and, by default, returns 0. To use it, every TDataSet descendant must override it in its specific way.
PSExecuteStatement returns the number of rows affected by executing ASQL.