Xceed DataGrid for WPF v7.2 Documentation
ColumnVirtualizationMode Property


Xceed.Wpf.DataGrid Assembly > Xceed.Wpf.DataGrid.Views Namespace > TableView Class : ColumnVirtualizationMode Property

Gets or sets a value indicating whether cells are virtualized and recycled, only virtualized, or not virtualized during scrolling.

Syntax
'Declaration
 
Public Property ColumnVirtualizationMode As ColumnVirtualizationMode
'Usage
 
Dim instance As TableView

Dim value As ColumnVirtualizationMode

 

instance.ColumnVirtualizationMode = value

 

value = instance.ColumnVirtualizationMode
public ColumnVirtualizationMode ColumnVirtualizationMode {get; set;}

Property Value

ColumnVirtualizationMode value indicating whether cells are virtualized and recycled, only virtualized, or not virtualized during scrolling. By default, Recycling.
Remarks

If having a low memory consumption is important in your environment, Recycling mode is the one to use, because cells will be created only for columns that are in view, and will be reused (thus recycled) between columns as new columns are scrolled into view. 

If horizontal scrolling performance is more important, choose the Virtualizing mode.  In this mode, all cells are created in advance, and assigned to a specific column.  Thus when a column is scrolled into view, the cost of preparing the cell is minimal, since it is already associated to the column.  When scrolling is done, though cells are still associated to a column, they are "virtualized" (put in a non-available state) as if they had not been created, and thus the DataGrid performance is preserved in other scenarios (e.g. live updating, vertical scrolling, group expending/collapsing) because the UI is still virtualized as when recycling. 

If memory and speed is not a concern, but cell availability is important, then use the None mode, as this will create all cells, and maintain them in a valid state at all times.

This property replaces the now obsolete IsColumnVirutalizationEnabled property.  The Recycling value corresponds to the true value of the IsColumnVirutalizationEnabled property.  Though the property is now obsolete, for backward compatibility reasons, it will still work if it is set at start up (e.g., through a style in xaml), but changes at runtime will not be considered.  Thus it will not require code changes if only set at start up.

Requirements

Target Platforms: Windows 11, Windows, 10, Windows 7, 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

See Also

Reference

TableView Class
TableView Members