LogicalTreeHelper.FindLogicalNode(DependencyObject, String) LogicalTreeHelper.FindLogicalNode(DependencyObject, String) LogicalTreeHelper.FindLogicalNode(DependencyObject, String) LogicalTreeHelper.FindLogicalNode(DependencyObject, String) Method

Definition

Versucht, ein Objekt mit dem angegebenen Namen zu suchen und zurückzugeben.Attempts to find and return an object that has the specified name. Die Suche startet beim angegebenen Objekt und wird in den untergeordneten Knoten der logischen Struktur fortgesetzt.The search starts from the specified object and continues into subnodes of the logical tree.

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.DependencyObject
Public Shared Function FindLogicalNode (logicalTreeNode As DependencyObject, elementName As String) As DependencyObject

Parameter

logicalTreeNode
DependencyObject DependencyObject DependencyObject DependencyObject

Das Objekt, bei dem die Suche begonnen werden soll.The object to start searching from. Bei diesem Objekt muss es sich um ein FrameworkElement oder um ein FrameworkContentElement handeln.This object must be either a FrameworkElement or a FrameworkContentElement.

elementName
String String String String

Der Name des zu suchenden -Objekts.The name of the object to find.

Gibt zurück

Das Objekt mit dem entsprechenden Namen, falls ein solches Element gefunden wird. Gibt null zurück, wenn kein entsprechender Name in der Struktur gefunden wird.The object with the matching name, if one is found; returns null if no matching name was found in the logical tree.

Hinweise

Die Methoden FrameworkContentElement.FindName und FrameworkElement.FindName sindsehrähnlichwie,funktionierenjedochmitunterschiedlicherLogik:FindLogicalNodeThe methods FrameworkContentElement.FindName and FrameworkElement.FindName are superficially similar to FindLogicalNode, but operate by different logic:

  • Die Suchrichtung für FindLogicalNode ist für untergeordnete Objekte (in der Struktur nach unten). die Such FindName Richtung für die Methoden erfolgt in Bezug auf übergeordnete Objekte (nach oben in der Struktur).The search direction for FindLogicalNode is toward child objects (down the tree); the search direction for the FindName methods is towards parent objects (up the tree).

  • Die FindName Methoden unterliegen dem Konzept eines XAML-Namescope.The FindName methods are governed by the concept of a XAML namescope. Mit FindName der Verwendung von können Sie sicherstellen, dass nur ein Objekt mit diesem Namen vorhanden ist, da XAML-Namescopes die Eindeutigkeit erzwingen.Using FindName you are guaranteed that only one object of that name exists, because XAML namescopes enforce uniqueness. Im Gegensatz dazu FindLogicalNode ignoriert XAML-Namescope und kann während der Suche die XAML-Namescope-Grenzen überschreiten.In contrast, FindLogicalNode ignores XAML namescope and might cross XAML namescope boundaries during the search. Daher gibt es keine Garantie für die elementName Eindeutigkeit des Namens, wenn Grenzen überschritten werden.As such, there is no guarantee of uniqueness of the elementName name once boundaries are crossed. Weitere Informationen zu XAML-Namescopes finden Sie unter WPF-XAML-Namescopes.For more information about XAML namescopes, see WPF XAML Namescopes.

Gilt für: