LogicalTreeHelper.FindLogicalNode(DependencyObject, String) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
嘗試尋找並傳回具有指定之名稱的物件。 搜尋將從指定的物件開始,並持續至邏輯樹狀結構的子節點。
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
參數
- logicalTreeNode
- DependencyObject
做為搜尋起點的物件。 這個物件必須是 FrameworkElement 或 FrameworkContentElement。
- elementName
- String
要尋找之物件的名稱。
傳回
具有相符名稱的物件 (如果找到的話)。如果在邏輯樹狀結構中找不到相符名稱,則傳回 null
。
備註
和 的方法 FrameworkContentElement.FindName FrameworkElement.FindName FindLogicalNode 與 類似,但由不同的邏輯操作:
的搜尋方向 FindLogicalNode 是指向樹狀結構) (子物件;方法的
FindName
搜尋方向是指向樹狀結構) (父物件。方法
FindName
是由 XAML 命名範圍的概念所控管。 使用FindName
可確保只有一個該名稱的物件存在,因為 XAML 名稱範圍會強制執行唯一性。 相反地, FindLogicalNode 忽略 XAML 名稱範圍,而且可能會在搜尋期間跨越 XAML 名稱範圍界限。 因此,一旦跨越界限,elementName
就不保證名稱的唯一性。 如需 XAML 名稱範圍的詳細資訊,請參閱 WPF XAML Namescopes。