DataTemplate.GetElement(ElementFactoryGetArgs) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Crea o recupera una instancia existente del objeto UIElement declarado en DataTemplate.
UIElement GetElement(ElementFactoryGetArgs const& args);
public UIElement GetElement(ElementFactoryGetArgs args);
function getElement(args)
Public Function GetElement (args As ElementFactoryGetArgs) As UIElement
Parámetros
Instancia de ElementFactoryGetArgs.
Devoluciones
Instancia de uiElement raíz declarada en DataTemplate o null si la raíz de DataTemplate no es uiElement.
Implementaciones
Requisitos de Windows
Familia de dispositivos |
Windows 10, version 1809 (se introdujo en la versión 10.0.17763.0)
|
API contract |
Windows.Foundation.UniversalApiContract (se introdujo en la versión v7.0)
|
Comentarios
DataTemplate actúa como un generador que genera el objeto de elemento declarado en su plantilla. A diferencia del método LoadContent que crea una nueva instancia cada vez que se invoca, el método GetElement puede crear una nueva instancia o devolver una instancia existente que se recicló a través de RecycleElement.
La implementación de DataTemplate de GetElement no usa el valor Data de ElementFactoryGetArgs. La propiedad Data existe para implementaciones como DataTemplateSelector donde se usa para decidir desde qué DataTemplate cargar contenido.