DataTemplate.RecycleElement(ElementFactoryRecycleArgs) 方法

定义

重要

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

编辑

回收以前使用 GetElement 检索的 UIElement。

void RecycleElement(ElementFactoryRecycleArgs const& args);

public void RecycleElement(ElementFactoryRecycleArgs args);

function recycleElement(args)

Public Sub RecycleElement (args As ElementFactoryRecycleArgs)

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

RecycleElement 方法用于保留元素供以后重复使用，但不会自动重置元素的当前状态。例如，如果以编程方式设置控件的背景，则再次添加到活动树时，该值将保留。

可以从 GetElement 返回的回收元素添加到活动树中，其方式与新创建的元素相同。

GetElement 尝试从已回收的实例中检索现有实例。如果未找到任何内容，则它将使用 LoadContent 创建一个新实例。

回收元素可能不会立即导致它从活动元素树中删除。在这种情况下，除非已将 Unloaded/Loaded 事件添加到活动树中的其他父元素，否则不会引发该事件。

调用 RecycleElement 时，不需要指定 Parent 。但是，建议使用它来启用性能优化。使用 Parent 值调用 GetElement 时，它将查找为同一 Parent 回收的元素。如果它们仍附加到父元素，则可以重新使用它们，而不会产生对元素重新设置父级的额外开销。

注意

RecycleElement 不会自动排除已回收元素参与 Tab 键顺序。它也不会隐藏元素的自动化对等，使其不显示在自动化树中。平台的内置虚拟化控件管理其控制下的元素的这一点。

如果要从头开始创建自定义虚拟化控件或在一次性方案中调用 RecycleElement，请注意，你有责任从 Tab 键顺序和自动化对等树中排除已回收的元素。

可以替代 GetChildrenInTabFocusOrder ，并提供框架应用于 Tab 焦点的已实现元素的子集。同样，控件的自动化对等应重写其 GetChildrenCore 并排除回收的元素。