RecordContainerRetentionMode Property

Gets or sets whether de-activated (i.e. unused) record containers will be retained in the visual tree for possible future use.

Syntax

Visual Basic

'Declaration
 
Public Property RecordContainerRetentionMode As RecordContainerRetentionMode

C#

public RecordContainerRetentionMode RecordContainerRetentionMode {get; set;}

Property Value

'RetainDeactivatedContainersPermanently' to retain unused record containers even after the DataSource is changed or cleared, 'RetainDeactivatedContainers' to retain unused record containers until the DataSource is changed or cleared, 'RetainDeactivatedContainersUntilResize' to retain them until the control is resized smaller, otherwise 'DiscardDeactivatedContainers'. The default is 'RetainDeactivatedContainersUntilResize'.

Remarks

If this property is set to 'RetainDeactivatedContainersPermanently', '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 RecordContainerGenerationMode is set to any value other than 'Recycle' or not using GridView or GridViewSettings.UseNestedPanels is true.

Note:If this property was set to 'RetainDeactivatedContainersPermanently' and then set to any other value all previously retained containers will de discarded.

Requirements

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