Datasnap.DBClient.TCustomClientDataSet.BeforeGetRecords
Delphi
property BeforeGetRecords: TRemoteEvent read FBeforeGetRecords write FBeforeGetRecords;
C++
__property TRemoteEvent BeforeGetRecords = {read=FBeforeGetRecords, write=FBeforeGetRecords};
Inhaltsverzeichnis
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
event | protected | Datasnap.DBClient.pas Datasnap.DBClient.hpp |
Datasnap.DBClient | TCustomClientDataSet |
Beschreibung
Tritt auf, bevor die Client-Datenmenge ein Datenpaket vom Provider abruft.
Sie können eine Ereignisbehandlungsroutine für BeforeGetRecords erstellen, um benutzerdefinierte Informationen an den Provider der Client-Datenmenge zu senden. BeforeGetRecords ist Teil des Mechanismus, mit dem Client-Datenmenge und Provider Informationen zum Abrufen der Daten austauschen. Wird auf einem statuslosen Anwendungsserver mit einem Provider gearbeitet, können Client-Datenmenge und Provider mit diesem Mechanismus persistente Statusinformationen austauschen.
Ruft die Client-Datenmenge Daten von einem Anwendungsserver ab, treten die folgenden Ereignisse auf:
- Die Client-Datenmenge empfängt das Ereignis BeforeGetRecords, in dem benutzerdefinierte Informationen in einer OleVariant-Struktur codiert werden, die dann als Parameter
OwnerData
an den Provider übergeben wird. - Der Provider empfängt ein BeforeGetRecords-Ereignis, in dem er auf Informationen antworten oder diese ändern kann, bevor ein Datenpaket erstellt wird.
- Der Provider erzeugt das Datenpaket.
- Der Provider empfängt ein AfterGetRecords-Ereignis, in dem er benutzerdefinierte Informationen in seinen Parameter
OwnerData
codieren oder auf Informationen antworten kann, die aus der Ereignisbehandlungsroutine für BeforeGetRecords stammen. - Die Client-Datenmenge erhält ein AfterGetRecords-Ereignis, in dem sie auf vom Provider in der Ereignisbehandlungsroutine AfterGetRecords gelieferten benutzerdefinierten Informationen antworten kann.
BeforeGetRecords ist eine Ereignisbehandlungsroutine des Typs Datasnap.DBClient.TRemoteEvent.