DataTemplate.GetElement(ElementFactoryGetArgs) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 UIElementParâmetros
Uma instância de ElementFactoryGetArgs.
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.