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
Параметры
Экземпляр ElementFactoryGetArgs.
Возвращаемое значение
Экземпляр корневого элемента UIElement , объявленного в DataTemplate , или null
, если корень DataTemplate
элемента не UIElement
является .
Реализации
Комментарии
DataTemplate выступает в качестве фабрики, которая создает объект элемента, объявленный в шаблоне. В отличие от метода LoadContent , который создает новый экземпляр при каждом вызове GetElement
, метод может либо создать новый экземпляр, либо вернуть существующий экземпляр, который был переработан с помощью RecycleElement.
GetElement
Реализация DataTemplate
объекта не использует значение Data из ElementFactoryGetArgs. Свойство Data существует для таких реализаций, как DataTemplateSelector , где оно используется для выбора, из какого объекта DataTemplate следует загружать содержимое .