Compartilhar via


DataTemplate.GetElement(ElementFactoryGetArgs) Método

Definição

Cria ou recupera uma instância existente do objeto UIElement declarado no DataTemplate.

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

Parâmetros

Retornos

Uma instância do UIElement raiz declarada no DataTemplate ou null se a raiz do DataTemplate não for um UIElement.

Implementações

Requisitos do Windows

Família de dispositivos
Windows 10, version 1809 (introduzida na 10.0.17763.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v7.0)

Comentários

O DataTemplate atua como uma fábrica que gera o objeto de elemento declarado em seu modelo. Ao contrário do método LoadContent que cria uma nova instância sempre que é invocado, o método GetElement pode criar uma nova instância ou retornar uma instância existente que foi reciclada por meio de RecycleElement.

A implementação de GetElement do DataTemplate não usa o valor Data do ElementFactoryGetArgs. A propriedade Data existe para implementações como DataTemplateSelector em que ela é usada para decidir de qual DataTemplate carregar conteúdo.

Aplica-se a

Confira também