Datasnap.Provider.TCustomProvider.BeforeGetRecords

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

property BeforeGetRecords: TRemoteEvent read FBeforeGetRecords write FBeforeGetRecords;

C++

__property Datasnap::Dbclient::TRemoteEvent BeforeGetRecords = {read=FBeforeGetRecords, write=FBeforeGetRecords};

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
event protected
Datasnap.Provider.pas
Datasnap.Provider.hpp
Datasnap.Provider TCustomProvider

Beschreibung

Wird ausgelöst, bevor der Provider ein Datenpaket erzeugt und an eine Client-Datenmenge sendet.

Mit einer BeforeGetRecords-Ereignisbehandlungsroutine antworten Sie auf benutzerdefinierte Informationen von der Client-Datenmenge. BeforeGetRecords ist Bestandteil des Mechanismus, anhand dessen eine Client-Datenmenge und ein Provider Informationen über das Abrufen von Daten austauschen. Bei einem statuslosen Anwendungsserver können die Client-Datenmenge und der Provider persistente Statusinformationen austauschen.

Wenn die Client-Datenmenge Daten von einem Provider abruft, werden die folgenden Ereignisse ausgelöst:

1. Die Client-Datenmenge erhält ein BeforeGetRecords-Ereignis, in dem die benutzerdefinierten Informationen in eine OleVariante codiert werden.

2. Der Provider erhält ein BeforeGetRecords-Ereignis, das die OleVariante der Client-Datenmenge in dem Parameter OwnerData enthält. Der Provider kann antworten oder die Informationen vor dem Erzeugen eines Datenpakets ändern.

3. Der Provider erzeugt das Datenpaket.

4. 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.

5. 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 des Typs Datasnap.DBClient.TRemoteEvent.

Siehe auch

Codebeispiele