RuntimeNamePropertyAttribute 類別

定義

命名空間:

System.Windows.Markup

組件:

System.Xaml.dll

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

public ref class RuntimeNamePropertyAttribute sealed : Attribute

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

[<System.AttributeUsage(System.AttributeTargets.Class)>]
type RuntimeNamePropertyAttribute = class
    inherit Attribute

Public NotInheritable Class RuntimeNamePropertyAttribute
Inherits 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 (WPF 中現有類別的範例，其中 RuntimeNamePropertyAttribute 套用 的) 為 FrameworkElement。 上的 NameFrameworkElement 屬性會以 RuntimeNamePropertyAttribute屬性化，這會導致任何 FrameworkElement 衍生類別也使用 Name 做為其運行時間名稱屬性。

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

建構函式

RuntimeNamePropertyAttribute(String)

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

屬性

Name	取得由這個 RuntimeNamePropertyAttribute 指定的執行階段名稱屬性名稱。
TypeId	在衍生類別中實作時，取得這個 Attribute 的唯一識別碼。 (繼承來源 Attribute)

方法

Equals(Object)	傳回值，這個值指出此執行個體是否與指定的物件相等。 (繼承來源 Attribute)
GetHashCode()	傳回這個執行個體的雜湊碼。 (繼承來源 Attribute)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
IsDefaultAttribute()	在衍生類別中覆寫時，表示這個執行個體的值是衍生類別的預設值。 (繼承來源 Attribute)
Match(Object)	在衍生類別中覆寫時，會傳回值，表示這個執行個體是否等於指定物件。 (繼承來源 Attribute)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

另請參閱

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