Partilhar via


VirtualizingStackPanel.VirtualizationMode Attached Property

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

Gets or sets how a panel in an ItemsControl virtualizes its child items.

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

Syntax

'Declaration
See GetVirtualizationMode, SetVirtualizationMode
See GetVirtualizationMode, SetVirtualizationMode
<object VirtualizingStackPanel.VirtualizationMode="Standard"/>
-or-
<object VirtualizingStackPanel.VirtualizationMode="Recycling"/>

Property Value

Type: System.Windows.Controls.VirtualizationMode
One of the VirtualizationMode values.

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 a lot of items, the process of creating and discarding item containers can negatively affect performance. When the VirtualizationMode attached property 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.

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.