VirtualizingLayoutContext.GetOrCreateElementAt Metodo

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml.Controls

Overload

GetOrCreateElementAt(Int32)	Recupera un UIElement che rappresenta l'elemento di dati nell'origine trovata nell'indice specificato. Per impostazione predefinita, se esiste già un elemento, viene restituito; in caso contrario, viene creato un nuovo elemento. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).
GetOrCreateElementAt(Int32, ElementRealizationOptions)	Recupera un UIElement che rappresenta l'elemento di dati nell'origine trovato nell'indice specificato usando le opzioni specificate. Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).

GetOrCreateElementAt(Int32)

Recupera un UIElement che rappresenta l'elemento di dati nell'origine trovata nell'indice specificato. Per impostazione predefinita, se esiste già un elemento, viene restituito; in caso contrario, viene creato un nuovo elemento.

Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).

public:
 virtual UIElement ^ GetOrCreateElementAt(int index) = GetOrCreateElementAt;

/// [Windows.Foundation.Metadata.Overload("GetOrCreateElementAt")]
UIElement GetOrCreateElementAt(int const& index);

[Windows.Foundation.Metadata.Overload("GetOrCreateElementAt")]
public UIElement GetOrCreateElementAt(int index);

Public Function GetOrCreateElementAt (index As Integer) As UIElement

Parametri

index

Int32

int

Indice dell'elemento di dati per recuperare un oggetto UIElement.

Restituisce

UIElement

UIElement che rappresenta l'elemento di dati.

Attributi

OverloadAttribute

Commenti

Questo metodo chiama GetOrCreateElementAtCore(System.Int32,Microsoft.UI.Xaml.Controls.ElementRealizationOptions) con opzioni impostate su Nessuno.

GetElementAtCore deve essere implementato in una classe derivata.

GetOrCreateElementAt(Int32, ElementRealizationOptions)

Recupera un UIElement che rappresenta l'elemento di dati nell'origine trovato nell'indice specificato usando le opzioni specificate.

Questa documentazione si applica a WinUI 2 per UWP (per WinUI nella SDK per app di Windows, vedere gli spazi dei nomi SDK per app di Windows).

public:
 virtual UIElement ^ GetOrCreateElementAt(int index, ElementRealizationOptions options) = GetOrCreateElementAt;

/// [Windows.Foundation.Metadata.Overload("GetOrCreateElementAt2")]
UIElement GetOrCreateElementAt(int const& index, ElementRealizationOptions const& options);

[Windows.Foundation.Metadata.Overload("GetOrCreateElementAt2")]
public UIElement GetOrCreateElementAt(int index, ElementRealizationOptions options);

Public Function GetOrCreateElementAt (index As Integer, options As ElementRealizationOptions) As UIElement

Parametri

index

Int32

int

Indice dell'elemento di dati per recuperare un oggetto UIElement.

options

ElementRealizationOptions

Valore di ElementRealizationOptions che specifica se eliminare il riciclo automatico dell'elemento recuperato o forzare la creazione di un nuovo elemento.

Restituisce

UIElement

UIElement che rappresenta l'elemento di dati.

Attributi

OverloadAttribute

Commenti

Questo metodo chiama GetOrCreateElementAtCore(System.Int32,Microsoft.UI.Xaml.Controls.ElementRealizationOptions) che deve essere implementato in una classe derivata.

Quando si richiede un elemento per l'indice specificato, è possibile specificare facoltativamente se eliminare il riciclo automatico dell'elemento recuperato o forzare la creazione di un nuovo elemento. Gli elementi recuperati con riciclo automatico soppressi (SuppressAutoRecycle) vengono ignorati dalla logica di riciclo automatico che cancella gli elementi realizzati che non sono stati recuperati come parte del passaggio di layout corrente. È necessario riciclare in modo esplicito questi elementi passandoli al metodo RecycleElement per evitare perdite di memoria.

Queste opzioni sono destinate a layout più avanzati che scelgono di gestire in modo esplicito la realizzazione e il riciclo degli elementi come ottimizzazione delle prestazioni.