VirtualizingLayoutContext.GetOrCreateElementAtCore Metodo

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml.Controls

Quando implementato in una classe derivata, 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).

protected:
 virtual UIElement ^ GetOrCreateElementAtCore(int index, ElementRealizationOptions options) = GetOrCreateElementAtCore;

UIElement GetOrCreateElementAtCore(int const& index, ElementRealizationOptions const& options);

protected virtual UIElement GetOrCreateElementAtCore(int index, ElementRealizationOptions options);

Protected Overridable Function GetOrCreateElementAtCore (index As Integer, options As ElementRealizationOptions) As UIElement

Parametri

index

Int32

int

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

options

ElementRealizationOptions

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.

Commenti

Questo metodo viene chiamato da GetOrCreateElementAt(System.Int32) e GetOrCreateElementAt(System.Int32,Microsoft.UI.Xaml.Controls.ElementRealizationOptions).

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 RecycleElementCore(Windows.UI.Xaml.UIElement) 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.