RuntimeNamePropertyAttribute 類別

定義

命名空間:

System.Windows.Markup

組件:

System.Xaml.dll

代表類型層級屬性，該屬性報告此類型中哪個屬性對應到 XAML x:Name 屬性。

C#

[System.AttributeUsage(System.AttributeTargets.Class)]
public sealed class RuntimeNamePropertyAttribute : Attribute

繼承

Object

Attribute

RuntimeNamePropertyAttribute

屬性

AttributeUsageAttribute

備註

中指定的 RuntimeNamePropertyAttribute 屬性必須是 型 String 別，而且必須是可擦寫的。

架構可能會將其中一個架構基底元素的特定屬性屬性設為 XAML 名稱對等專案。 如此一來，在 XAML 載入時間設定的 XAML 名稱範圍中 XAML 名稱的概念就可供架構在運行時間的程式設計模型使用。

XAML 名稱值必須使用 XamlName 文法。

在舊版 .NET Framework 中，這個類別存在於 WPF 特定的元件 WindowsBase 中。 在 .NET Framework 4 中， RuntimeNamePropertyAttribute 位於 System.Xaml 元件中。 如需詳細資訊，請參閱 Types Migrated from WPF to System.Xaml。

WPF 使用注意事項

Windows Presentation Foundation 中現有類別的範例， (套用 的 RuntimeNamePropertyAttribute WPF) 為 FrameworkElement。 上的 NameFrameworkElement 屬性會以 RuntimeNamePropertyAttribute屬性化，這會導致任何 FrameworkElement 衍生類別也使用 Name 作為其運行時間名稱屬性。

一般而言，除非您實作新的或 FrameworkElement平行架構層級類別，否則您通常不需要在 WPF 中套用此屬性。 x:Name 如果兩者都以元素上的屬性的形式存在，而且 XAML 處理器實作通常擲回，則應該優先於運行時間名稱屬性。

建構函式

RuntimeNamePropertyAttribute(String)

初始化 RuntimeNamePropertyAttribute 類別的新執行個體。

屬性

Name	取得由這個 RuntimeNamePropertyAttribute 指定的執行階段名稱屬性名稱。

適用於

另請參閱

• 自定義類型和連結庫的 XAML 相關 CLR 屬性
• 定義與 .NET XAML 服務搭配使用的自定義類型
• XAML 服務
• x：Name 屬性
• XAMLName 文法