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 语法