'Declaration Public Enum RecordContainerRetentionMode Inherits System.Enum
public enum RecordContainerRetentionMode : System.Enum
Member | Description |
---|---|
DiscardDeactivatedContainers | On layout updated any record containers that are not being used in the display (i.e. deactivated and collapsed) will be discarded. |
RetainDeactivatedContainers | All record containers that are not being used in the display (i.e. deactivated and collapsed) will be retained for later use. This can help optimize scrolling performance in cases where the mix of DataRecords, GroupByRecords and SummaryRecords in the display changes. However, old containers can be discarded after the DataSource has been changed |
RetainDeactivatedContainersPermanently | All record containers that are not being used in the display (i.e. deactivated and collapsed) will be retained for later use even after the DataSource is changed. The record containers will be discarded only after the property is set to one of the other values. |
RetainDeactivatedContainersUntilResize | (Default) All record containers that are not being used in the display (i.e. deactivated and collapsed) will be retained for later use until the control is resized smaller in the scrolling dimension. This can help optimize scrolling performance in cases where the mix of DataRecords, GroupByRecords and SummaryRecords in the display changes. |
Note: if the property is set 'RetainDeactivatedContainers' or 'RetainDeactivatedContainersUntilResize' then any record containers that have already been hydrated but are not used in the current display will be retained in the visual tree (collapsed) so that they can be recycled in the future. Depending on the scenario, e.g. if the mix of DataRecords, GroupByRecords and SummaryRecords in the display changes, this can improve scrolling performance. This property is ignored if DataPresenterBase.RecordContainerGenerationMode is set to any value other than 'Recycle' or not using GridView or GridViewSettings.UseNestedPanels is true.
Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2