LogicalTreeHelper.FindLogicalNode(DependencyObject, String) 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.
Versucht, ein Objekt mit dem angegebenen Namen zu suchen und zurückzugeben. Die Suche beginnt mit dem angegebenen Objekt und setzt sich in Unterknoten der logischen Struktur fort.
public:
static System::Windows::DependencyObject ^ FindLogicalNode(System::Windows::DependencyObject ^ logicalTreeNode, System::String ^ elementName);public static System.Windows.DependencyObject FindLogicalNode(System.Windows.DependencyObject logicalTreeNode, string elementName);static member FindLogicalNode : System.Windows.DependencyObject * string -> System.Windows.DependencyObjectPublic Shared Function FindLogicalNode (logicalTreeNode As DependencyObject, elementName As String) As DependencyObjectParameter
- logicalTreeNode
- DependencyObject
Das Objekt, von dem aus die Suche gestartet werden soll. Dieses Objekt muss ein FrameworkElement oder ein FrameworkContentElement.
- elementName
- String
Der Name des zu suchenden Objekts.
Gibt zurück
Das Objekt mit dem übereinstimmenden Namen, wenn ein Objekt gefunden wird; gibt zurück null , wenn in der logischen Struktur kein übereinstimmener Name gefunden wurde.
Hinweise
Die Methoden FrameworkContentElement.FindName und FrameworkElement.FindName sind oberflächlich ähnlich wie FindLogicalNode, aber arbeiten sie durch unterschiedliche Logik:
Die Suchrichtung FindLogicalNode liegt in Richtung untergeordneter Objekte (nach unten in der Struktur); die Suchrichtung für die
FindNameMethoden liegt in Richtung übergeordneter Objekte (nach oben in der Struktur).Die
FindNameMethoden unterliegen dem Konzept eines XAML-NameScopes. Durch die VerwendungFindNamewird sichergestellt, dass nur ein Objekt dieses Namens vorhanden ist, da XAML-NameScopes die Eindeutigkeit erzwingen. Im Gegensatz dazu FindLogicalNode ignoriert XAML-NameScope und kann während der Suche XAML-NameScope-Grenzen überschreiten. Daher gibt es keine Garantie für die Eindeutigkeit deselementNameNamens, sobald Grenzen überschritten werden. Weitere Informationen zu XAML-NameScopes finden Sie unter WPF XAML NameScopes.
