FireDAC.Comp.DataSet.TFDMasterDataLink.DisableDelayedScroll

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure DisableDelayedScroll;

C++

void __fastcall DisableDelayedScroll();

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
procedure
function
public
FireDAC.Comp.DataSet.pas
FireDAC.Comp.DataSet.hpp
FireDAC.Comp.DataSet TFDMasterDataLink

Beschreibung

Deaktiviert die verzögerte Aktualisierung der Detaildatenmenge.

Mit der Methode DisableDelayedScroll der MasterLink-Eigenschaft der Detaildatenmenge deaktivieren Sie die verzögerte Aktualisierung der Detaildatenmenge. Stattdessen wird die sofortige Aktualisierung verwendet. Die Methode hat nur Auswirkungen, wenn eine verzögerte Aktualisierung aktiviert ist.

Die Methode ist in Anwendungscode nützlich, in dem die Hauptdatenmenge durchlaufen werden muss und zudem die Datensätze der Detaildatenmenge gelesen werden müssen. Außerdem verfügt die Detaildatenmenge über ein TFDDataSet-Objekt als Wert. Eigenschaftswert von FetchOptions.DetailDelay > 0. Dies ermöglicht die Kombination der verzögerten Aktualisierung der Detaildatenmenge mit der synchronisierten Aktualisierung im Code, wenn der Benutzer in der Hauptdatenmenge im GUI einen Bildlauf durchführt.

Mit der Methode EnableDelayedScroll können Sie die verzögerte Aktualisierung der Detaildatenmenge wieder aktivieren. Die Methodenaufrufe von DisableDelayedScroll/EnableDelayedScroll müssen paarweise erfolgen und können verschachtelt sein. FireDAC verfolgt anhand eines Zählers die verschachtelten Aufrufe von DisableDelayedScroll/EnableDelayedScroll. Der oberste Aufruf der Methode DisableDelayedScroll synchronisiert die Detaildatenmenge mit der Hauptdatenmenge, falls sie nicht bereits synchronisiert sind.

Mit der Methode Synchronize synchronisieren Sie die Detaildatenmenge mit der Hauptdatenmenge.

Beispiel

 
 qDetail.MasterLink.DisableDelayedScroll;
 try
   qMaster.First;
   while not qMaster.Eof do begin
     if qMaster.Fields[i].AsInteger = 100 then begin
       // read qDetail dataset - it is synchronized with qMaster
     end;
     qMaster.Next;
   end;
 finally
   qDetail.MasterLink.EnableDelayedScroll;
 end;

Siehe auch