VirtualizingLayoutContext.GetOrCreateElementAtCore Método

Definição

Namespace:

Microsoft.UI.Xaml.Controls

Quando implementado em uma classe derivada, recupera um UIElement que representa o item de dados na fonte encontrada no índice especificado usando as opções especificadas.

Esta documentação se aplica ao WinUI 2 para UWP (para WinUI no SDK do Aplicativo Windows, consulte os namespaces SDK do Aplicativo 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

O índice do item de dados para o qual recuperar um UIElement .

options

ElementRealizationOptions

Especifica se é necessário suprimir a reciclagem automática do elemento recuperado ou forçar a criação de um novo elemento.

Retornos

UIElement

Um UIElement que representa o item de dados.

Comentários

Esse método é chamado por GetOrCreateElementAt(System.Int32) e GetOrCreateElementAt(System.Int32,Microsoft.UI.Xaml.Controls.ElementRealizationOptions).

Ao solicitar um elemento para o índice especificado, você pode, opcionalmente, especificar se deseja suprimir a reciclagem automática do elemento recuperado ou forçar a criação de um novo elemento. Os elementos recuperados com a reciclagem automática suprimida (SuppressAutoRecycle) são ignorados pela lógica de reciclagem automática que limpa os elementos realizados que não foram recuperados como parte da passagem de layout atual. Você deve reciclar explicitamente esses elementos passando-os para o método RecycleElementCore (Windows.UI.Xaml.UIElement) para evitar vazamentos de memória.

Essas opções destinam-se a layouts mais avançados que optam por gerenciar explicitamente a realização e a reciclagem de elementos como uma otimização de desempenho.