VirtualizingLayoutContext.GetOrCreateElementAt Метод

Определение

Пространство имен:

Microsoft.UI.Xaml.Controls

Перегрузки

GetOrCreateElementAt(Int32)	Извлекает элемент UIElement, представляющий элемент данных в источнике, найденном по указанному индексу. По умолчанию, если элемент уже существует, он возвращается; в противном случае создается новый элемент .
GetOrCreateElementAt(Int32, ElementRealizationOptions)	Извлекает элемент UIElement, представляющий элемент данных в источнике, найденном по указанному индексу, с помощью указанных параметров.

GetOrCreateElementAt(Int32)

Извлекает элемент UIElement, представляющий элемент данных в источнике, найденном по указанному индексу. По умолчанию, если элемент уже существует, он возвращается; в противном случае создается новый элемент .

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);

function getOrCreateElementAt(index)

Public Function GetOrCreateElementAt (index As Integer) As UIElement

Параметры

index

Int32

int

Индекс элемента данных, для которого извлекается элемент UIElement.

Возвращаемое значение

UIElement

Элемент UIElement, представляющий элемент данных.

Атрибуты

OverloadAttribute

Комментарии

Этот метод вызывает Метод GetOrCreateElementAtCore(System.Int32,Microsoft.UI.Xaml.Controls.ElementRealizationOptions) с параметрамиNone.

GetElementAtCore должен быть реализован в производном классе.

GetOrCreateElementAt(Int32, ElementRealizationOptions)

Извлекает элемент UIElement, представляющий элемент данных в источнике, найденном по указанному индексу, с помощью указанных параметров.

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);

function getOrCreateElementAt(index, options)

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

Параметры

index

Int32

int

Индекс элемента данных, для которого извлекается элемент UIElement.

options

ElementRealizationOptions

Значение ElementRealizationOptions , указывающее, следует ли подавлять автоматический перезапуск полученного элемента или принудительно создавать новый элемент.

Возвращаемое значение

UIElement

Элемент UIElement, представляющий элемент данных.

Атрибуты

OverloadAttribute

Комментарии

Этот метод вызывает Метод GetOrCreateElementAtCore(System.Int32,Microsoft.UI.Xaml.Controls.ElementRealizationOptions), который должен быть реализован в производном классе.

При запросе элемента для указанного индекса при необходимости можно указать, следует ли подавлять автоматический перезапуск полученного элемента или принудительно создавать новый элемент. Элементы, полученные с подавляемым автоматическим перезапуском (SuppressAutoRecycle), игнорируются логикой автоматического перезапуска, которая очищает реализованные элементы, которые не были получены в рамках текущего этапа макета. Эти элементы необходимо явно перезапустить, передав их в метод RecycleElement , чтобы избежать утечек памяти.

Эти параметры предназначены для более сложных макетов, которые явно управляют реализацией и перезапуском элементов в качестве оптимизации производительности.