NameScope 类

定义

命名空间:

System.Windows

程序集:

WindowsBase.dll

实现对 INameScope 方法的基本 WPF 支持，这些方法用于向特定 XAML 名称范围中存储名称-对象映射或检索此类映射。 添加附加属性支持，以便更简单地在元素级别动态获取或设置 XAML 名称范围的名称。

public ref class NameScope : System::Collections::Generic::ICollection<System::Collections::Generic::KeyValuePair<System::String ^, System::Object ^>>, System::Collections::Generic::IDictionary<System::String ^, System::Object ^>, System::Collections::Generic::IEnumerable<System::Collections::Generic::KeyValuePair<System::String ^, System::Object ^>>, System::Windows::Markup::INameScopeDictionary

public class NameScope : System.Collections.Generic.ICollection<System.Collections.Generic.KeyValuePair<string,object>>, System.Collections.Generic.IDictionary<string,object>, System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<string,object>>, System.Windows.Markup.INameScopeDictionary

type NameScope = class
    interface ICollection<KeyValuePair<string, obj>>
    interface seq<KeyValuePair<string, obj>>
    interface IEnumerable
    interface IDictionary<string, obj>
    interface INameScope
    interface INameScopeDictionary

Public Class NameScope
Implements ICollection(Of KeyValuePair(Of String, Object)), IDictionary(Of String, Object), IEnumerable(Of KeyValuePair(Of String, Object)), INameScopeDictionary

继承

Object

NameScope

实现

ICollection<KeyValuePair<String,Object>> ICollection<KeyValuePair<TKey,TValue>> IDictionary<String,Object> IEnumerable<KeyValuePair<String,Object>> IEnumerable<KeyValuePair<TKey,TValue>> IEnumerable<T> IEnumerable INameScopeDictionary

注解

此类实现对 XAML 的 WPF 处理的内置 XAML 名称范围支持。 NameScope 协助基于分析 XAML 创建初始 XAML 名称范围，例如实例化样式和模板时。 它还支持通过 WPF XAML 处理器实现在正常 XAML 加载元素之外发生的进程创建 XAML 名称范围。

NameScope 通常更致力于提供基础结构，而不是涉及使用 XAML 名称范围的常见用户代码方案。 对于大多数方案，FindName在 和 FrameworkContentElement 上FrameworkElement公开的方法是调用以按 XAML 定义的名称搜索元素的更合适的方法。 Name和 FrameworkContentElement 公开的属性FrameworkElement是更合适的属性，用于将初始名称设置为标记属性。

的各种方法 NameScope 由维护 XAML 名称范围的基元素和其他类使用，以支持 RegisterName 和 FindName。 通常，只有在替换或扩充基元素行为以使其处理 XAML 页面根元素的 XAML 名称范围时，才在 类中使用 NameScope API，并且作为模板 (的一部分，该行为使用与页面) 其余部分不同的 XAML 名称范围。

在 .NET Framework 4 中， NameScope 提供集合接口实现，以便你可以访问由 XAML 名称范围保存的名称集合，包括通过调用Add方法添加到其中。

有关 XAML 名称范围概念的详细信息，请参阅 WPF XAML 名称范围。

XAML 名称范围中的名称必须使用特定的语法来限制可用于 API 输入的 NameScope 字符串。 请参阅 XamlName 语法。

构造函数

NameScope()

初始化 NameScope 类的新实例。

字段

NameScopeProperty

标识 NameScope 附加属性。

属性

Count	返回此 NameScope 中映射名称的集合中的项数。
IsReadOnly	获取一个值，该值指示集合是否为只读。
Item[String]	获取或设置具有指定键的项。
Keys	获取 NameScope 字典中键的集合。
Values	获取 NameScope 字典中值的集合。

附加属性

NameScope

获取或设置动态附加的 NameScope 实例。

方法

Add(KeyValuePair<String,Object>)	向集合中添加一项。
Add(String, Object)	向集合中添加一项。
Clear()	从集合中移除所有项。
Contains(KeyValuePair<String,Object>)	确定集合是否包含指定的项。
ContainsKey(String)	返回此 NameScope 中是否已存在所提供的名称。
CopyTo(KeyValuePair<String,Object>[], Int32)	从特定的数组索引开始，将集合的元素复制到数组中。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
FindName(String)	根据提供的名称字符串，返回由此 NameScope 保留的 XAML 名称范围中的相应对象。
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetNameScope(DependencyObject)	为 NameScope 附加属性提供附加属性 get 访问器。
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
RegisterName(String, Object)	将新的名称-对象对注册到当前的 XAML 名称范围中。
Remove(KeyValuePair<String,Object>)	从集合中移除特定对象。
Remove(String)	从集合中移除指定名称的映射。
SetNameScope(DependencyObject, INameScope)	为 NameScope 附加属性提供附加属性 set 访问器。
ToString()	返回表示当前对象的字符串。 (继承自 Object)
TryGetValue(String, Object)	获取与指定键关联的值。
UnregisterName(String)	从 XAML 名称范围中删除名称对象映射。

显式接口实现

IEnumerable.GetEnumerator()	返回循环访问集合的枚举数。
IEnumerable<KeyValuePair<String,Object>>.GetEnumerator()	返回循环访问集合的枚举数。

扩展方法

另请参阅

• INameScope