Questa documentazione è stata archiviata e non viene gestita.

Enumerazione VirtualizationMode

Aggiornamento: Luglio 2008

Specifica il metodo utilizzato da VirtualizingStackPanel per gestire la virtualizzazione dei relativi elementi figlio.

Spazio dei nomi:  System.Windows.Controls
Assembly:  PresentationFramework (in PresentationFramework.dll)

public enum VirtualizationMode
public enum VirtualizationMode
public enum VirtualizationMode
object property="enumerationValue".../>

Nome membroDescrizione
Standard Crea ed elimina i contenitori di elementi.
Recycling Riutilizza i contenitori di elementi.

Per impostazione predefinita, VirtualizingStackPanel crea un contenitore di elementi per ogni elemento visibile e lo elimina quando non è più necessario, ad esempio quando l'elemento è fuori visualizzazione. Quando ItemsControl contiene molti elementi, il processo di creazione ed eliminazione di contenitori di elementi può influire negativamente sulle prestazioni. Quando VirtualizationMode() è impostato su Recycling, VirtualizingStackPanel riutilizza i contenitori di elementi anziché crearne uno nuovo ogni volta.

Quando VirtualizingStackPanel non è in grado di riciclare contenitori di elementi, utilizza la modalità standard di virtualizzazione, che consiste nella creazione e nell'eliminazione di contenitori di elementi per ogni elemento. Nell'elenco seguente sono descritti i casi in cui VirtualizingStackPanel non è in grado di riciclare contenitori di elementi:

  • ItemsControl contiene contenitori di elementi di tipi diversi. Ad esempio, è possibile che Menu includa elementi che utilizzano sia oggetti MenuItem che Seperator come contenitori di elementi.

  • I contenitori di elementi vengono creati in modo esplicito per ItemsControl. Per ulteriori informazioni sulla differenza tra la creazione esplicita e implicita di contenitori di elementi, vedere la sezione "Classi di contenitori di elementi" in Cenni preliminari sul modello di contenuto dei controlli.

Nell'esempio seguente viene creato un oggetto ListBox e la proprietà associata VirtualizationMode() viene impostata su Recycling.

<StackPanel>

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

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

</StackPanel>


Nell'esempio seguente vengono illustrati i dati utilizzati nell'esempio precedente.

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


.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

.NET Framework

Supportato in: 3.5 SP1, 3.0 SP1

Riferimenti

VirtualizingStackPanelVirtualizationMode()

Date

Cronologia

Motivo

Luglio 2008

Argomento aggiunto per una nuova enumerazione.

Modifica di funzionalità in SP1.

Mostra: