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.
Реализации
Требования к 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 следует загружать содержимое .