Soap.SOAPDm.TSoapDataModule.Execute

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

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

C++

void __fastcall Execute(const System::WideString ProviderName, const System::WideString CommandText, System::OleVariant &Params, System::OleVariant &OwnerData);

Properties

Type Visibility Source Unit Parent
procedure
function
protected
Soap.SOAPDm.pas
Soap.SOAPDm.hpp
Soap.SOAPDm TSoapDataModule

Description

Executes the query or stored procedure bound to a specified provider.

Execute provides the underlying implementation for the AS_Execute method (on the IAppServer interface) and the SAS_Execute method (on the IAppServerSOAP interface). It calls the Execute method of the specified provider after assigning any parameters. Output parameters that result from executing a query or stored procedure are returned in Params.

ProviderName specifies the name of the provider component associated with the query or stored procedure.

CommandText specifies an optional SQL statement that replaces the SQL of the provider's query, or the name of a stored procedure that replaces the provider's underlying stored procedure. This parameter is ignored if the Options property does not include poAllowCommandText.

Params encodes any parameters expected by the query or stored procedure and returns any output parameters. To create a properly encoded value for Params from a TParams object, use the PackageParams method.

OwnerData contains custom information that appears as an argument to the provider's BeforeExecute and AfterExecute event handlers. This information originates in a client dataset's BeforeExecute event handler. The value returned in OwnerData is passed to the client dataset's AfterExecute event handler.

See Also