DataTemplate.GetElement(ElementFactoryGetArgs) Methode
Definition
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.
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 UIElementParameter
Eine instance von ElementFactoryGetArgs.
Gibt zurück
Eine instance des in dataTemplate deklarierten UIElement-Stammelements oder NULL, wenn der Stamm der DataTemplate kein UIElement ist.
Implementiert
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.