名称范围既是一种概念,也是用于存储对象的 XAML 定义名称及其实例等效项之间的关系的编程对象。加载 XAML 应用程序的页面时,即在 WPF 托管代码中创建了名称范围。作为编程对象的名称范围由 INameScope 接口定义,并且还由实际类 NameScope 实现。
加载的 XAML 应用程序中的名称范围
处理 XAML 页时,即对该页的根元素创建了名称范围。该页中指定的每个名称都会添加到相关的名称范围中。作为常见根元素(例如 Page 和 Window)的元素总是控制名称范围。如果在标记中某个元素(例如 FrameworkElement 或 FrameworkContentElement)是页的根元素,则 XAML 处理器会隐式添加一个 Page 根元素,以便 Page 可以提供一个名称范围。即使最初在 XAML 中没有定义 Name 或 x:Name 属性,也会创建一个名称范围。
如果试图在任意名称范围中两次使用同一个名称,则会引发异常。对于具有代码隐藏并且是已编译的应用程序的一部分的 XAML,在创建页的已生成类时会引发该异常。
将元素添加到已分析的元素树
若要在初始的加载和处理之后向元素树添加任何元素,都必须对定义名称范围的类调用相应的 RegisterName 的实现。否则,无法通过 FindName 等方法按名称引用添加的对象。仅设置 Name 属性(或 x:Name 属性)不会将该名称注册到任何名称范围中。将命名的元素添加到具有名称范围的元素树中也不会将此名称注册到名称范围中。尽管名称范围可以嵌套,但通常您应该将名称注册到根元素上存在的名称范围中,这样您的名称范围位置便可与在等效的加载 XAML 页中可能已创建的名称范围并列。 应用程序开发人员最常用的方案是使用 RegisterName 将名称注册到当前根元素的名称范围中。RegisterName 是查找将作为动画运行的演示图板的一种重要方案的一部分。有关更多信息,请参见演示图板概述。如果您对同一逻辑树中的非根元素的元素调用 RegisterName,则该名称仍然会注册到最靠近根元素的元素,就好像对该根元素调用了 RegisterName 一样。
代码中的名称范围
对于以编程方式创建(而不是来自加载的 XAML)的应用程序,若要支持名称范围,根元素必须实现 INameScope、或者必须是 FrameworkElement 或 FrameworkContentElement 派生类。
此外,对于不是由 XAML 处理器加载和处理的任何元素,默认情况下不会创建或初始化该对象的名称范围。必须为随后要向其中注册名称的任何元素显式创建新的名称范围。若要为元素创建名称范围,可调用静态 SetNameScope 方法。将该元素指定为 dependencyObject 参数,并且将新的 NameScope 构造函数调用指定为 value 参数。
如果作为 SetNameScope 的 dependencyObject 提供的对象不是 INameScope 实现,也不是 FrameworkElement 或 FrameworkContentElement,那么,对任何子元素调用 RegisterName 均无效。如果您无法显式创建新的名称范围,则调用 RegisterName 将引发异常。
样式和模板中的名称范围
WPF 中的样式和模板提供了以简单的方法重新使用和重新应用内容的功能,但样式和模板可能还包括具有在模板级别指定的名称的元素。同一个模板可能在某个页中被多次重复使用。因此,样式和模板都定义其自己的名称范围,而与样式或模板所应用到的包含页无关。
请看下面的示例:
此处,同一个模板被应用到两个不同的按钮。如果模板没有独立的名称范围,则该模板中用到的