DataTemplate.GetElement(ElementFactoryGetArgs) Метод

Определение

Создает или извлекает существующий экземпляр объекта UIElement , объявленного в DataTemplate.

UIElement GetElement(ElementFactoryGetArgs const& args);
public UIElement GetElement(ElementFactoryGetArgs args);
function getElement(args)
Public Function GetElement (args As ElementFactoryGetArgs) As UIElement

Параметры

args
ElementFactoryGetArgs

Экземпляр ElementFactoryGetArgs.

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

Экземпляр корневого элемента UIElement , объявленного в DataTemplate , или null , если корень DataTemplate не является uiElement.

Реализации

Требования к Windows

Семейство устройств
Windows 10, version 1809 (появилось в 10.0.17763.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v7.0)

Комментарии

DataTemplate выступает в качестве фабрики, которая создает объект элемента, объявленный в своем шаблоне. В отличие от метода LoadContent , который создает новый экземпляр при каждом вызове, метод GetElement может либо создать новый экземпляр, либо вернуть существующий экземпляр, который был переработан с помощью RecycleElement.

Реализация DataTemplate GetElement не использует значение Data из ElementFactoryGetArgs. Свойство Data существует для таких реализаций, как DataTemplateSelector , где оно используется для выбора того, из какого объекта DataTemplate следует загружать содержимое .

Применяется к

См. также раздел