Skip to main content
All docs
V26.1
  • TdxBackendDataSetJSONConnection.AutoRefreshData Property

    Specifies if the data connection component automatically refreshes data from associated datasets.

    Declaration

    property AutoRefreshData: Boolean read; write; default True;

    Property Value

    Type Default Description
    Boolean True

    Specifies if cached data is automatically updated from underlying datasets (TDataSet descendant instances):

    True
    Default. The data connection component automatically reloads and re-serializes data from associated datasets every time a TdxDashboard/TdxDashboardControl/TdxReport/TdxReportControl component starts to import data for design, preview, and export operations. You can call the TdxCustomDashboardControl.ReloadData procedure to reload and re-serialize data from associated datasets on demand.

    Note

    Data refresh operations may take a noticeable amount of time and have significant memory footprint depending on the number and size of associated datasets.

    False
    The data connection component loads and serializes data only once. No additional checks or data refresh operations are executed. TdxCustomDashboardControl.ReloadData procedure calls have no effect on the current data connection component.

    Tip

    This option may be useful if source data does not change at runtime.

    Remarks

    You can set the AutoRefreshData property to False to speed up data population if source datasets remain unchanged during the current session.

    Refresh Data on Demand

    You can call the following procedures to reload data and update content on demand when the AutoRefreshData property is set to True:

    TdxCustomDashboardControl.ReloadData
    Reloads data from all underlying data sources on demand and updates dashboard content.
    TdxCustomReportControl.ReloadData
    Reloads data from all underlying data sources on demand and updates report content.

    Default Value

    The AutoRefreshData property’s default value is True.

    See Also