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 UIElement
Parâ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
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 GetElement
método pode criar uma nova instância ou retornar uma instância existente que foi reciclada por meio de RecycleElement.
A DataTemplate
implementação de GetElement
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.