DataTemplate.GetElement(ElementFactoryGetArgs) Método

Definição

Namespace:

Windows.UI.Xaml

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

args

ElementFactoryGetArgs

Uma instância de ElementFactoryGetArgs.

Retornos

UIElement

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

Implementações

GetElement(ElementFactoryGetArgs)

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.

Confira também

• IElementFactory
• DataTemplate.RecycleElement
• DataTemplateSelector.GetElement
• DataTemplateSelector.RecycleElement