Datasnap.DBClient.TCustomClientDataSet.BeforeGetRecords

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

property BeforeGetRecords: TRemoteEvent read FBeforeGetRecords write FBeforeGetRecords;

C++

__property TRemoteEvent BeforeGetRecords = {read=FBeforeGetRecords, write=FBeforeGetRecords};

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:

  1. 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.
  2. Der Provider empfängt ein BeforeGetRecords-Ereignis, in dem er auf Informationen antworten oder diese ändern kann, bevor ein Datenpaket erstellt wird.
  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 eine Ereignisbehandlungsroutine des Typs Datasnap.DBClient.TRemoteEvent.

Siehe auch

Codebeispiele