DataTemplate.GetElement(ElementFactoryGetArgs) Methode

Referenz

Definition

Namespace:: Windows.UI.Xaml

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Erstellt oder ruft eine vorhandene instance des IN DataTemplate deklarierten UIElement-Objekts ab.

UIElement GetElement(ElementFactoryGetArgs const& args);

public UIElement GetElement(ElementFactoryGetArgs args);

function getElement(args)

Public Function GetElement (args As ElementFactoryGetArgs) As UIElement

Parameter

args: ElementFactoryGetArgs

Eine instance von ElementFactoryGetArgs.

Gibt zurück

UIElement

Eine instance des in dataTemplate deklarierten UIElement-Stammelements oder NULL, wenn der Stamm der DataTemplate kein UIElement ist.

Implementiert

GetElement(ElementFactoryGetArgs)

Windows-Anforderungen

Gerätefamilie	Windows 10, version 1809 (eingeführt in 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v7.0)

Hinweise

Die DataTemplate fungiert als Factory, die das in der Vorlage deklarierte Elementobjekt generiert. Im Gegensatz zur LoadContent-Methode, die bei jedem Aufruf eine neue instance erstellt, kann die GetElement-Methode entweder eine neue instance erstellen oder eine vorhandene instance zurückgeben, die über RecycleElement wiederverwendet wurde.

Die DataTemplate-Implementierung von GetElement verwendet nicht den Data-Wert aus elementFactoryGetArgs. Die Data-Eigenschaft ist für Implementierungen wie DataTemplateSelector vorhanden, in denen sie verwendet wird, um zu entscheiden, aus welcher DataTemplate Inhalt geladen werden soll.

Gilt für: