LogicalTreeHelper.FindLogicalNode(DependencyObject, String) Metodo

Definizione

Tenta di trovare e restituire un oggetto con il nome specificato.Attempts to find and return an object that has the specified name. La ricerca comincia dall'oggetto specificato e continua con i nodi secondari dell'albero logico.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

Parametri

logicalTreeNode
DependencyObject

Oggetto da cui cominciare la ricerca.The object to start searching from. Questo oggetto deve essere un tipo FrameworkElement oppure FrameworkContentElement.This object must be either a FrameworkElement or a FrameworkContentElement.

elementName
String

Nome dell'oggetto da trovare.The name of the object to find.

Restituisce

Oggetto con il nome corrispondente, se viene trovato; restituisce null se nessun nome corrispondente viene trovato nell'albero logico.The object with the matching name, if one is found; returns null if no matching name was found in the logical tree.

Commenti

I metodi FrameworkContentElement.FindName e FrameworkElement.FindName sono apparentemente simili a FindLogicalNode, ma operano in base a una logica diversa:The methods FrameworkContentElement.FindName and FrameworkElement.FindName are superficially similar to FindLogicalNode, but operate by different logic:

  • La direzione di ricerca FindLogicalNode per è verso gli oggetti figlio (nell'albero); la direzione di ricerca FindName per i metodi è verso gli oggetti padre (fino all'albero).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).

  • I FindName metodi sono regolati dal concetto di ambito dei nomi XAML.The FindName methods are governed by the concept of a XAML namescope. L' FindName uso di un utente garantisce che esista un solo oggetto con tale nome, perché gli ambiti dei nomi XAML applicano l'univocità.Using FindName you are guaranteed that only one object of that name exists, because XAML namescopes enforce uniqueness. Al contrario, FindLogicalNode ignora l'ambito dei nomi XAML e può attraversare i limiti del NameScope XAML durante la ricerca.In contrast, FindLogicalNode ignores XAML namescope and might cross XAML namescope boundaries during the search. Di conseguenza, non esiste alcuna garanzia di univocità del elementName nome una volta superati i limiti.As such, there is no guarantee of uniqueness of the elementName name once boundaries are crossed. Per ulteriori informazioni sugli ambiti dei nomi XAML, vedere NAMESCOPE XAML WPF.For more information about XAML namescopes, see WPF XAML Namescopes.

Si applica a