Datasnap.Provider.TCustomProvider.DoBeforeExecute
Delphi
procedure DoBeforeExecute(const CommandText: OleStr; var Params,
OwnerData: OleVariant); virtual;
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 | TCustomProvider |
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 verbundenen Abfrage ersetzt, oder den Namen einer Stored Procedure an, die die verbundene Stored Procedure ersetzt. Wenn poAllowCommandText in Options nicht enthalten ist, wird dieser Parameter ignoriert.
Params enthält die Parameterwerte, die in CommandText oder in die Abfrage oder in die Stored Procedure vor der Ausführung eingetragen werden sollen.
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.
Gemäß der Implementierung in TCustomProvider werden CommandText und Params ignoriert. Abgeleitete Klassen tragen diese Werte vor der Erzeugung des Ereignisses BeforeExecute ein.