Export (0) Print
Expand All
Expand Minimize

VirtualizationMode Enumeration

Specifies the method the VirtualizingStackPanel uses to manage virtualizing its child items.

Namespace:  System.Windows.Controls
Assembly:  System.Windows (in System.Windows.dll)

public enum VirtualizationMode
<object property = "enumMemberName"/>

Member nameDescription
Supported by Silverlight for Windows PhoneStandardCreate and discard the item containers.
Supported by Silverlight for Windows PhoneRecyclingReuse the item containers.

By default, a VirtualizingStackPanel creates an item container for each visible item and discards it when it is no longer needed (such as when the item is scrolled out of view). When an ItemsControl contains many items, the process of creating and discarding item containers can negatively affect performance. When VirtualizationModeProperty is set to Recycling, the VirtualizingStackPanel reuses item containers instead of creating a new one each time.

When VirtualizingStackPanel cannot recycle item containers, it uses the standard mode of virtualization, which is to create and discard item containers for each item. The following list describes cases when the VirtualizingStackPanel cannot recycle item containers:

  • The ItemsControl contains item containers of different types.

  • You explicitly create the item containers for the ItemsControl.

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Community Additions

ADD
Show:
© 2015 Microsoft