DataTemplate.GetElement(ElementFactoryGetArgs) 方法

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

编辑

创建或检索 DataTemplate 中声明的 UIElement 对象的现有实例。

UIElement GetElement(ElementFactoryGetArgs const& args);

public UIElement GetElement(ElementFactoryGetArgs args);

function getElement(args)

Public Function GetElement (args As ElementFactoryGetArgs) As UIElement

在 DataTemplate 中声明的根 UIElement 的实例;如果 DataTemplate 的根不是 UIElement，则为 null。

设备系列	Windows 10, version 1809 (在 10.0.17763.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v7.0 中引入)

DataTemplate 充当工厂，生成在其模板中声明的元素对象。与每次调用时创建新实例的 LoadContent 方法不同，GetElement 方法可以创建新实例，也可以返回通过 RecycleElement 回收的现有实例。

DataTemplate 的 GetElement 实现不使用 ElementFactoryGetArgs 中的数据值。 Data 属性存在于 DataTemplateSelector 等实现中，用于决定从哪个 DataTemplate 加载内容。