Datasnap.DBClient.TCustomClientDataSet.Params

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

property Params: TParams read FParams write SetParams;

C++

__property Data::Db::TParams* Params = {read=FParams, write=SetParams};

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
property protected
Datasnap.DBClient.pas
Datasnap.DBClient.hpp
Datasnap.DBClient TCustomClientDataSet

Beschreibung

Enthält Parameterwerte, die an den Provider gesendet werden.

Mit Params können Sie Parameterwerte angeben, die der Provider an eine Quelldatenmenge übergeben soll. Wenn die Client-Datenmenge einen internen Provider verwendet, gibt Params die Werte aller Parameter für die in der Eigenschaft CommandText definierte SQL-Anweisung an. Verwendet die Client-Datenmenge einen externen Provider, der einer Datenmenge zugeordnet ist, die eine Abfrage oder Stored Procedure repräsentiert, stellen diese Parameterwerte Eingabeparameterwerte für die Abfrage oder Stored Procedure bereit und geben die Ausgabeparameter der Stored Procedure zurück. Ist der Provider einer TTable- oder TSQLTable-Komponente zugeordnet, beschränkt Params die Datensätze, die in Datenpaketen gesendet werden. Nach dem Angeben der Parameter (zur Entwurfs- oder Laufzeit) werden diese automatisch an den Provider gesendet, wenn die Client-Datenmenge mit der Methode Execute Daten abruft oder eine Abfrage bzw. Stored Procedure ausführt.

Sollen Parameterwerte an eine Abfrage oder Stored Procedure gesendet werden, muss für jeden Parameter der Abfrage oder Stored Procedure, für den die Client-Datenmenge einen Wert senden soll, ein Parameterobjekt (TParam) in Params eingefügt werden. Weisen Sie jedem Objekt die Name-, DataType- und ParamType-Werte der entsprechenden Parameter in der Abfrage oder Stored Procedure zu. Diese Werte werden automatisch codiert und an den Provider gesendet, sobald die Client-Datenmenge Daten abruft.

Sollen Parameterwerte an ein Objekt des Typs TTable oder TSQLTable gesendet werden, muss für jedes Feld in der Tabelle, welches die in Datenpaketen zu sendenden Werte beschränkt, ein Parameterobjekt übergeben werden. Weisen Sie jedem Objekt die Name- und DataType-Werte der entsprechenden Feldkomponente zu. Diese Parameterwerte werden automatisch gesendet, wenn die Client-Datenmenge Daten abruft. In den Datenpaketen vom Provider werden nur Datensätze zurückgegeben, die dem den jeweiligen Feldern zugewiesenen Wert entsprechen. Sie können diese Wirkung auch erzielen, indem Sie dem Feld einen Filter zuweisen, der Einsatz von Params ist jedoch effizienter, da die Daten nicht in Datenpakete eingefügt werden müssen.

Anmerkung:  Um Params so zu initialisieren, dass die Eigenschaft den Parametern der Abfrage oder Stored Procedure eines Providers entspricht, rufen Sie die Methode FetchParams auf.

Warnung:  Die Parameter werden dem Provider nur übergeben, wenn die Client-Datenmenge erstmals Daten abruft und eine Abfrage oder Stored Procedure ausgeführt wird. Mit der Methode Execute können Sie die Parameterwerte ändern und die erneute Ausführung der Abfrage oder Stored Procedure mit den neuen Werten veranlassen.

Siehe auch

Codebeispiele