Partager via


VirtualizationMode Enumeration

Microsoft Silverlight will reach end of support after October 2021. Learn more.

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

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

Syntax

'Declaration
Public Enumeration VirtualizationMode
public enum VirtualizationMode
<object property = "enumMemberName"/>

Members

Member name Description
Supported by Silverlight for Windows Phone Standard Create and discard the item containers.
Supported by Silverlight for Windows Phone Recycling Reuse the item containers.

Remarks

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.

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

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

Platforms

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