AmbientAttribute 类

定义

命名空间:

System.Windows.Markup

程序集:

System.Xaml.dll

指定应将某个属性或类型视为环境。 环境概念涉及 XAML 处理器如何确定成员的类型所有者。

public ref class AmbientAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Method | System.AttributeTargets.Property, Inherited=true)]
public sealed class AmbientAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Method | System.AttributeTargets.Property, Inherited=true)>]
type AmbientAttribute = class
    inherit Attribute

Public NotInheritable Class AmbientAttribute
Inherits Attribute

继承

Object

Attribute

AmbientAttribute

属性

AttributeUsageAttribute

注解

环境属性是一个属性，其中的值应在创建对象图时在分析器上下文中可用，但在创建直接 XAML 节点集时，典型的类型成员查找被挂起。 环境概念有两种main方案：

• 同一对象的一些其他属性会影响和限定该对象属性查找的工作方式。

• 属性表示更大的延迟机制，用于查找成员值的环境功能扩展到当前 对象中包含的所有对象。

此属性可以应用于具有启用环境属性查找行为的预期容器的特定属性，也可以应用于类，以便在该值类型的所有情况下都为属性启用环境属性行为。

AmbientAttribute 还可以应用于 CLR 方法，以支持将 XAML 可附加属性归为环境。 这可能是必需的，因为在 CLR 实现中，XAML 附加属性是使用 get 和 set 方法作为访问器模式实现/表示给反射的。 不存在对 属性的实际 CLR 属性，因此将 的使用限制 AttributeTargets 为 Property 不会启用将可附加成员指定为环境。 对于要作为环境报告的可附加成员，请将 get 访问器特性化。 不应尝试对不专门支持可附加成员的方法进行特性化。

在早期版本的 .NET Framework中，此类存在于特定于 WPF 的程序集 WindowsBase 中。 在 .NET Framework 4 中， AmbientAttribute 位于 System.Xaml 程序集中。 有关详细信息，请参阅 Types Migrated from WPF to System.Xaml。

环境类型 (类型，其中 AmbientAttribute 在类型级别应用) 可用于需要无序解析属性类型的某些 XAML 处理情况。

对象编写器方案

如果要定义 XAML 对象编写器，并且遇到应用 了 AmbientAttribute 的属性、方法或类型，则通常必须访问服务以确定写出对象所需的预期环境属性查找行为。 有关详细信息，请参阅 IAmbientProvider。

值转换器

类型转换器或标记扩展可能需要知道环境信息才能处理表示间接类型映射的属性，例如通过字符串名称指定成员或类型的属性（无论是否限定）。 在此方案中， AmbientAttribute 不应直接用于值转换器代码逻辑。 相反，值转换器应依赖于 XAML 编写器处理行为，该行为会在调用时将其服务上下文传递给 IAmbientProvider 值转换器方法。

AmbientAttribute 的 WPF 方案

• Style (TargetType 的属性) 可以限定查找值中Setter.Property属性名称的后备引用所需的属性名称查找。

• 属性中的所有 Resources 内容 (ResourceDictionary) 项以及模板内容，都应能够访问其他对等方作为值。 将整个 Resources 属性声明为环境调用逻辑，从而在 WPF XAML 分析器中启用此功能。

有关在类型级别设置AmbientAttribute的方案示例，请参阅 ResourceDictionary 。

构造函数

AmbientAttribute()

初始化 AmbientAttribute 类的新实例。

属性

TypeId

在派生类中实现时，获取此 Attribute 的唯一标识符。 (继承自 Attribute)

方法

Equals(Object)	返回一个值，该值指示此实例是否与指定的对象相等。 (继承自 Attribute)
GetHashCode()	返回此实例的哈希代码。 (继承自 Attribute)
GetType()	获取当前实例的 Type。 (继承自 Object)
IsDefaultAttribute()	在派生类中重写时，指示此实例的值是否是派生类的默认值。 (继承自 Attribute)
Match(Object)	当在派生类中重写时，返回一个指示此实例是否等于指定对象的值。 (继承自 Attribute)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ToString()	返回表示当前对象的字符串。 (继承自 Object)

另请参阅

• IsAmbient
• XamlMember
• IAmbientProvider
• 自定义类型和库的 XAML 相关 CLR 属性
• 定义与 .NET XAML 服务一起使用的自定义类型
• XAML 服务