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 | |
|---|---|---|
.gif "Supported by Silverlight for Windows Phone") |
Standard | Create and discard the item containers. |
|
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.