VirtualizationMode Enumeração

Definição

Espaço de Nomes:
System.Windows.Controls
Assemblagem:
PresentationFramework.dll

Especifica o método que utiliza VirtualizingStackPanel para gerir a virtualização dos seus itens filhos.

public enum class VirtualizationMode
public enum VirtualizationMode
type VirtualizationMode = 
Public Enum VirtualizationMode
Herança
Object
ValueType
Enum
VirtualizationMode

Campos

Name Valor Description
Standard 0

Cria e descarta os recipientes dos itens.
Recycling 1

Reutiliza os recipientes dos itens.

Exemplos

O exemplo seguinte cria um ListBox e define a VirtualizationMode propriedade associada para Reciclagem.

<StackPanel>

  <StackPanel.Resources>
    <src:LotsOfItems x:Key="data"/>
  </StackPanel.Resources>

  <ListBox Height="150" ItemsSource="{StaticResource data}" 
             VirtualizingStackPanel.VirtualizationMode="Recycling" />

</StackPanel>

O exemplo seguinte mostra os dados usados no exemplo anterior.

public class LotsOfItems : ObservableCollection<String>
{
    public LotsOfItems()
    {
        for (int i = 0; i < 1000; ++i)
        {
            Add("item " + i.ToString());
        }
    }
}

Public Class LotsOfItems
    Inherits ObservableCollection(Of String)
    Public Sub New()
        For i As Integer = 0 To 999
            Add("item " & i.ToString())
        Next
    End Sub
End Class

Observações

Por defeito, a VirtualizingStackPanel cria um contentor de itens para cada item visível e descarta-o quando já não é necessário (como quando o item está deslocado fora de vista). Quando contém ItemsControl muitos itens, o processo de criação e descarte de recipientes pode afetar negativamente o desempenho. Quando VirtualizationMode está definido para Reciclagem, reutiliza VirtualizingStackPanel recipientes de itens em vez de criar um novo cada vez.

Quando VirtualizingStackPanel não é possível reciclar contentores de itens, utiliza o modo padrão de virtualização, que consiste em criar e descartar contentores de itens para cada item. A lista seguinte descreve casos em que não é VirtualizingStackPanel possível reciclar recipientes de itens:

  • Contém ItemsControl recipientes de itens de diferentes tipos. Por exemplo, a Menu pode ter itens que usam ambos MenuItem e Separator objetos como recipientes de itens.

  • Cria-se explicitamente os contentores de itens para o ItemsControl.

Aplica-se a

Ver também