FireDAC.Stan.Option.TFDFetchOptions.RecsMax
Delphi
property RecsMax: Integer read GetRecsMax write SetRecsMax
C++
__property int RecsMax = {read=GetRecsMax, write=SetRecsMax, stored=IsRMS, default=-1};
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
property | published | FireDAC.Stan.Option.pas FireDAC.Stan.Option.hpp |
FireDAC.Stan.Option | TFDFetchOptions |
Beschreibung
Steuert die maximal Anzahl der Datensätze, die abgerufen werden sollen.
Mit RecsMax beschränken Sie die Anzahl der Datensätze, die aus einer einzelnen Ergebnismenge abgerufen werden sollen. Um RecsMax für eine bereits vorbereitete Datenmenge zu ändern, muss in der Anwendung zuerst die Methode Disconnect aufgerufen werden.
FireDAC gibt nur die ersten RecsMax Datensätze zurück, andere Datensätze werden verworfen. Der Wert -1 bedeutet keine Beschränkung. Wenn diese Eigenschaft mit Mode = fmExactRecsMax
kombiniert wird, dann löst FireDAC eine Exception aus, sofern die Anzahl der Datensätze in der Ergebnismenge nicht gleich RecsMax ist. Die Kombination der Eigenschaften RecsSkip und RecsMax ermöglicht die Implementierung von seitenweise aufgeteilten Ergebnismengen (nützlich für Webanwendungen). Zudem kann in Anwendungen auch die Escape-Funktion LIMIT verwendet werden. Wenn beides angegeben ist, dann hat LIMIT eine höhere Priorität.
Abhängig vom DBMS können RecsMax und RecsSkip in Klauseln von SELECT-Anweisungen (TOP, LIMIT etc.) übersetzt und damit Ergebnismengen auf der Serverseite beschränkt werden. Falls ein DBMS solche Klauseln nicht unterstützt, wird die Beschränkung auf dem Client durchgeführt.
Der Vorgabewert ist -1.