.net - XAML 解析器如何识别 NameScopes？

Question

在 XAML 解析的上下文中，我想知道解析器如何知道类型何时定义了 NameScope。

是否完全依赖INameScope接口(interface)，检查instance是INameScope？

它是否依赖于 bool 属性 XamlType.IsNameScope？

是两者的结合吗？

Answer 1

Microsoft 文档对此有一些很好的信息:

By default when used by .NET Framework XAML Services API, the primary XAML namescope is defined at the XAML root element of a single XAML production, and encompasses the elements that are contained in that XAML production.

这里的要点是，任何 Xaml 文档中的根元素都有一个为其创建的名称范围。 无论该元素是否实现了 INameScope(事实上，没有核心 UI 元素实现)，这种情况都会发生。

Additional discrete XAML namescopes that might occur within a single XAML production can be defined by frameworks to address specific scenarios. For example, in WPF, new XAML namescopes are defined and created by any template that is also defined on that XAML production. For more information about XAML namescopes (written for WPF but relevant for many XAML namescope concepts), see WPF XAML Namescopes.

除了为根元素创建的名称范围外，名称范围是为 Xaml 产品中定义的任何模板隐式创建的。这应该不足为奇，因为 FrameworkTemplate 实现了 INameScope，因此 DataTemplate 和 ControlTemplate 也是如此。还为 Style 元素创建名称范围。

您可能会注意到 ResourceDictionary 也实现了 INameScope，但它有点极端:资源字典中的对象名称​​实际上 在任何运行时名称范围内注册。如果查看实现，您会发现它的 INameScope 方法要么抛出 NotSupportedException，什么也不做，要么返回 null。这种设计很好地包含了名称。它们被阻止在任何父范围内注册，同时使它们可用于有限的目的，例如在 Binding 上使用 ElementName 引用。重申一下，资源字典作为名称范围是一种边缘情况，实际上，您永远不必考虑。

除了上面概述的隐式创建的范围之外，还会为任何对象创建节点的 Xaml 解析器框架创建一个新的名称范围，其中创建的对象实现了 INameScope。与所有名称范围一样，注册名称​​在该范围内 必须是唯一的；但是，它们可能会与堆栈更上层的其他名称范围中的名称发生冲突。

当从 Xaml 中具体化一个对象时，XamlObjectWriter 通过在堆栈中查找具有名称范围的帧来解析名称，一旦找到包含所需名称的范围就停止。例如，当评估来自 x:Reference 指令的延迟引用时，就会发生这种情况。

Does it rely entirely on the INameScope interface, checking instance is INameScope?
Does it rely on the boolean property XamlType.IsNameScope?

通常是后者，但该标志是通过确定类型是否可分配给映射到 System.Windows.Markup.INameScope 的 Xaml INameScope 类型来设置的。它不检查运行时实例，而是检查相应对象创建节点的 XamlType。从概念上讲，检查类似于 typeof(INameScope).IsAssignableFrom(instanceType)。

虽然你没有问，但为了完整起见，我想说最后一点:

When is an object registered in a name scope?

这在两种情况下发生:

1. 您在 Xaml 元素上明确设置了 x:Name 伪属性；
2. 您设置一个类似于 FrameworkElement.Name 的属性，它被定义为一个运行时名称属性。

像 FrameworkElement 这样的类型有它们自己的 Name 属性，而不是强制开发人员指定 Name 和 x:Name，他们提供了一种将 CLR 属性映射到 x:Name 的方法。如果查看 FrameworkElement 的源代码，您将看到一个 [RuntimeNameProperty("Name")] 属性。这会告诉 Xaml 基础结构，任何 FrameworkElement 上的 Name 属性都对应于 x:Name，并且设置一个应该导致设置另一个以及。请注意，运行时名称属性可以具有任何有效名称；它不需要被称为 Name。