FrameworkContentElement.Name 屬性

定義

命名空間:

System.Windows

組件:

PresentationFramework.dll

取得或設定元素的識別名稱。 這個名稱提供了一個實例參考，讓程式化的代碼背後（code-back），例如事件處理程式，能在解析 XAML 時指向一個元素。

public:
 property System::String ^ Name { System::String ^ get(); void set(System::String ^ value); };

[System.Windows.Localizability(System.Windows.LocalizationCategory.NeverLocalize)]
public string Name { get; set; }

[<System.Windows.Localizability(System.Windows.LocalizationCategory.NeverLocalize)>]
member this.Name : string with get, set

Public Property Name As String

屬性值

String

元素的名稱。

實作

Name

屬性

LocalizabilityAttribute

備註

此特性最常見的用途是在標記中指定 XAML 元素名稱時。

此屬性本質上提供了一個 WPF 框架層級的便利性，用以設定 XAML x：Name 指令。

取得 Name from code 並不常見，因為如果你已經有適當的參考，只要在元素參考上呼叫方法和屬性，通常 Name不需要 。 例外是字串有過載意義，例如在 UI 中顯示該名稱有用。 如果原本Name的 FROMCODE 是從標記設定，也不建議設定 fromName，且更改屬性也不會改變物件參考。 這類物件參考僅在 XAML 載入時明確建立底層命名範圍時才會被建立。

您必須特別致電 RegisterName ，對已負載元件的物業進行有效變更 Name 。

一個值得注意的是 Name ，設定程式碼很重要，就是用來命名分鏡要對應的元素。 在你註冊名稱之前，可能還需要實例化並指派一個 NameScope 實例。 請參閱範例章節或 分鏡腳本概覽。

從程式碼設定 Name 的應用有限，但以名稱查詢元素較為常見，特別是當你採用導覽模型時，頁面會重新載入應用程式，且執行時程式碼不一定是該頁面的程式碼。 效用方法 FindName可從任意 FrameworkContentElement中取得，可遞迴地在該元素的邏輯樹中找到任意 Name 元素。 或者你可以使用 FindLogicalNode 靜態方法 LogicalTreeHelper，也將 Name 字串作為參數。

常用的根元素（Window例如 ） Page 實作介面 INameScope。 此介面的實作預期將強制名稱在其範圍內明確無歧義。

相依財產資訊

項目	價值
識別碼欄位	NameProperty
元資料屬性設為 true	IsAnimationProhibited

另請參閱

• NameScope