Datasnap.Provider.TDataSetProvider.DoBeforeExecute

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure DoBeforeExecute(const CommandText: OleStr; var Params,  OwnerData: OleVariant); override;

C++

virtual void __fastcall DoBeforeExecute(const System::WideString CommandText, System::OleVariant &Params, System::OleVariant &OwnerData);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
procedure
function
protected
Datasnap.Provider.pas
Datasnap.Provider.hpp
Datasnap.Provider TDataSetProvider

Beschreibung

Erzeugt ein BeforeExecute-Ereignis.

DoBeforeExecute wird von der Methode Execute zum Erzeugen eines BeforeExecute-Ereignisses aufgerufen, bevor CommandText oder eine zugehörige Abfrage oder Stored Procedure ausgeführt wird.

CommandText gibt entweder eine optionale SQL-Anweisung, die die SQL-Anweisung einer zugehörigen Abfrage ersetzt, oder den Namen einer Stored Procedure an, die die zugehörige Stored Procedure ersetzt. Wenn Options poAllowCommandText enthält, sendet DoBeforeExecute CommandText an die zugehörige Datenmenge, damit die vorgesehene Anweisung anstelle der Abfrage oder Stored Procedure ausgeführt werden kann.

Params enthält die Parameterwerte, die in CommandText oder in die Abfrage oder in die Stored Procedure vor der Ausführung eingetragen werden sollen. DoBeforeExecute weist diese Parameterwerte der Datenmenge zu (wenn erforderlich).

OwnerData stellt für die Ereignisbehandlungsroutine BeforeExecute benutzerdefinierte Informationen bereit. In der Ereignisbehandlungsroutine kann dieser Wert geändert werden. Der Rückgabewert wird dann an eine AfterExecute-Ereignisbehandlungsroutine übergeben und anschließend an den Aurrufer der Methode Execute zurückgeliefert.

Siehe auch