VirtualizingLayoutContext.GetOrCreateElementAtCore Método

Definición

Espacio de nombres:

Microsoft.UI.Xaml.Controls

Cuando se implementa en una clase derivada, recupera un UIElement que representa el elemento de datos del origen que se encuentra en el índice especificado mediante las opciones especificadas.

Esta documentación se aplica a WinUI 2 para UWP (para WinUI en la SDK de Aplicaciones para Windows, consulta los espacios de nombres SDK de Aplicaciones para 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

Parámetros

index

Int32

int

Índice del elemento de datos para el que se va a recuperar un uiElement .

options

ElementRealizationOptions

Especifica si se debe suprimir el reciclaje automático del elemento recuperado o forzar la creación de un nuevo elemento.

Devoluciones

UIElement

UiElement que representa el elemento de datos.

Comentarios

GetOrCreateElementAt(System.Int32) y GetOrCreateElementAt(System.Int32,Microsoft.UI.Xaml.Controls.ElementRealizationOptions) llaman a este método.

Si solicita un elemento para el índice especificado, puede especificar opcionalmente si se debe suprimir el reciclaje automático del elemento recuperado o forzar la creación de un nuevo elemento. Los elementos recuperados con reciclaje automático suprimido (SuppressAutoRecycle) se omiten mediante la lógica de reciclaje automática que borra los elementos realizados que no se recuperaron como parte del paso de diseño actual. Debes reciclar explícitamente estos elementos pasandolos al método RecycleElementCore(Windows.UI.Xaml.UIElement) para evitar pérdidas de memoria.

Estas opciones están pensadas para diseños más avanzados que eligen administrar explícitamente la realización y el reciclaje de elementos como una optimización del rendimiento.