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 UIElement
Parameter
Eine instance von ElementFactoryGetArgs.
Gibt zurück
Eine instance des in der DataTemplate deklarierten UIElement-Stammelements oder null
, wenn der Stamm von DataTemplate
kein UIElement
ist.
Implementiert
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 verwendet GetElement
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.