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

Definición

Intenta buscar y devolver el objeto con el nombre especificado.Attempts to find and return an object that has the specified name. La búsqueda se inicia a partir del objeto especificado y continúa en los subnodos del árbol lógico.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

Parámetros

logicalTreeNode
DependencyObject DependencyObject DependencyObject DependencyObject

Objeto a partir del cual se va a iniciar la búsqueda.The object to start searching from. Este objeto debe ser un objeto FrameworkElement o FrameworkContentElement.This object must be either a FrameworkElement or a FrameworkContentElement.

elementName
String String String String

Nombre del objeto que se va a buscar.The name of the object to find.

Devoluciones

Objeto con el nombre especificado, si se encuentra uno; devuelve null si no se encuentra ningún objeto con el nombre especificado en el árbol lógico.The object with the matching name, if one is found; returns null if no matching name was found in the logical tree.

Comentarios

Los métodos FrameworkContentElement.FindName y FrameworkElement.FindName son superficialmente similares a FindLogicalNode, pero funcionan mediante lógica diferente:The methods FrameworkContentElement.FindName and FrameworkElement.FindName are superficially similar to FindLogicalNode, but operate by different logic:

  • La dirección de búsqueda FindLogicalNode para es hacia los objetos secundarios (hacia abajo en el árbol); la FindName dirección de búsqueda de los métodos es hacia los objetos primarios (hacia arriba en el árbol).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).

  • Los FindName métodos se rigen por el concepto de un ámbito de nombres XAML.The FindName methods are governed by the concept of a XAML namescope. Se FindName garantiza que solo existe un objeto con ese nombre, ya que los ámbitos de nombres XAML exigen la unicidad.Using FindName you are guaranteed that only one object of that name exists, because XAML namescopes enforce uniqueness. En cambio, FindLogicalNode omite el ámbito de nombres XAML y podría cruzar los límites del ámbito de nombres XAML durante la búsqueda.In contrast, FindLogicalNode ignores XAML namescope and might cross XAML namescope boundaries during the search. Como tal, no hay ninguna garantía de exclusividad del nombre elementName una vez que se superan los límites.As such, there is no guarantee of uniqueness of the elementName name once boundaries are crossed. Para obtener más información sobre los ámbitos de código XAML, vea ámbitos de código XAML de WPF.For more information about XAML namescopes, see WPF XAML Namescopes.

Se aplica a