Datasnap.DBClient.TCustomClientDataSet.Execute

Übergeordnet: TCustomClientDataSet

Delphi

procedure Execute; virtual;

C++

virtual void __fastcall Execute();

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
procedure function	public	Datasnap.DBClient.pas Datasnap.DBClient.hpp	Datasnap.DBClient	TCustomClientDataSet

Beschreibung

Führt einen SQL-Befehl der Datenmenge des Providers aus.

Mit Execute kann die Client-Datenmenge mit einer Abfrage oder Stored Procedure interagieren, die keine Ergebnismenge generiert. Rufen Sie Execute auf, um den in CommandText oder von der Abfrage bzw. Stored Procedure des Providers angegebenen Befehl auszuführen. Ist CommandText kein leerer String und wurde in der Eigenschaft Options des Providers das Bereitstellen eines Werts in CommandText durch Clients aktiviert, übergibt Execute CommandText zusammen mit der Eigenschaft Params (mit den Parametern für die Anweisung) an den Provider. Andernfalls weist Execute den Provider an, die Werte in Params zuzuweisen und die zugeordnete Abfrage oder Stored Procedure auszuführen. Nach dem Ausführen der entsprechenden Anweisung gibt der Provider die Ausgabeparameter zurück. Execute aktualisiert die Eigenschaft Params entsprechend.

Ruft die Anwendung Execute auf, empfängt die Client-Datenmenge ein BeforeExecute-Ereignis, bevor die Anforderung an die Providerkomponente übergeben wird. Nachdem der Provider die Abfrage oder Stored Procedure ausgeführt hat, gibt er gegebenenfalls die Ausgabeparameter zurück, die der Aktualisierung der Eigenschaft Params dienen. Schließlich empfängt die Client-Datenmenge ein AfterExecute-Ereignis.

Anmerkung: Verwenden Sie Execute nicht zum Ausführen einer Abfrage oder Stored Procedure, die einen Cursor zurückgibt. Die meisten Datenmengen verwenden zum Ausführen von Abfragen und Stored Procedures separate Befehle, wenn Daten zurückgegeben bzw. nicht zurückgegeben werden. Übergibt ein Provider den Befehl Execute an seine Datenmenge, verwendet die Datenmenge den Befehl zum Ausführen von Abfragen oder Stored Procedures, die keinen Cursor zurückgeben.