扩展标记(Markup Extensions)
扩展标记和类型转换器类似,它使我们可以扩展XAML的表现力。它既可以在运行时计算字符串属性(除了某些因性能原因而在编译时计算的内建扩展标记以外)的值,又可以基于字符串值来产生合适的变量。就像类型转换器,WPF提供了许多内建的扩展标记,它们都从MarkupExtension类派生。
不像类型转换器,扩展标记在XAML中拥有显式且一致的语法。正因为如此,扩展标记是扩展XAML的良好途径。此外,扩展标记还使我们能够克服现有类型转换器的潜在限制,而这些限制我们又无力修改。比如,在我们想要使用简单的字符串值来将某个控件的背景设置为渐变画刷,则可以编写支持这个功能的自定义扩展标记,即使内建的BrushConverter不支持这个想法。
XAML编译器/解析器会把写入一对花括号中的属性当作扩展标记来处理,而非字符串常量(或者一些需要类型转换器的东西)。下面的Button使用了三个不同的扩展标记:
<Button xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
Background="{x:Null}"
Height="{x:Static SystemParameters.IconHeight}"
Content="{Binding Path=Height, RelativeSource={RelativeSource Self}}" />
每个花括号中的第一个标识符是扩展标记类的名称。习惯上,这些类以后缀Extension结尾,然而在XAML中我们也可以不加。在上面的示例中,NullExtension(见x:Null)和StaticExtension(见x:Static)都是System.Windows.Markup命名空间中的类,因此需要添加x前缀。Binding(没有x前缀)是在System.Windows.Data命名空间中的,因此可以在默认的XML命名空间中找到它。
如果扩展标记支持,则可以使用逗号分隔多个扩展标记。位置参数(如SystemParameters.IconHeight)被当作扩展类相应构造函数的字符串参数(StaticExtension类包括一个重载的构造函数,以一个System.String为参数)。命名参数(如Path和RelativeSource)使得我们可以在构造的扩展对象上设置指定的属性。这些属性的值可是扩展标记本身的值(使用内嵌的花括号,如RelativeSource)或者是能够通过一般类型转换处理的字符串常量。扩展标记与.NET自定义特性很相似,设置和使用扩展标记的意图正是如此。
(对位置参数的处理方式,实际上就是(以伪码表示)
StaticExtension ext = new StaticExtension(SystemParameters.IconHeight);
而命名参数则为(以伪码表示)
Binding binding = new Binding();
binding.Path = Height;
binding.RelativeSource = new RelativeSource(RaltiveSourceMode.Self);)
上例中,NullExtension允许将Background属性设置为空画刷,而BrushConverter则不允许。StaticExtension允许是静态属性、字段、常量和枚举值,而非在XAML中硬编码的常量。本例将Button的Height属性设置为操作系统当前的图标高度,该值由System.Windows.SystemParameters类的静态属性IconHeight提供。Binding允许将Button的Content属性设置为与其Height属性相同的值。
如下例,Button的Content属性会被当作字符串常量,而非扩展标记,因为它包含了转义花括号({}):
<Button xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
Content="{}{非扩展标记}" />
同样的,也可以不用转义花括号而使用属性元素语法来设置字符串常量:
<Button xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation">
<Button.Content>{非扩展标记}</Button.Content>
</Button>
由于扩展标记就是拥有默认构造方法的类,因此它们也可以应用属性元素语法,如下:
<Button xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
<Button.Background>
<x:Null />
</Button.Background>
<Button.Height>
<x:Static Member="SystemParameters.IconHeight" />
</Button.Height>
<Button.Content>
<Binding Path="Height">
<Binding.RelativeSource>
<RelativeSource Mode="Self" />
</Binding.RealtiveSource>
</Binding>
</Button.Content>
</Button>
与扩展标记可以使用参数化的构造方法不同,属性元素语法中的对象元素均由默认的构造方法构造,因此需要为其设置相应的属性。如StaticExtension的Member属性,它与之前传递到其参数化构造方法中的参数具有相同的含义。
上例等价的程序代码如下:
System.Windows.Controls.Button b = new System.Windows.Controls.Button();
b.Background = null;
b.Height = System.Windows.SysteParameters.IconHeight;
System.Windows.Data.Binding binding = new System.Windows.Data.Binding();
binding.Path = new System.Windows.PropertyPath("Height");
binding.RelativeSource = System.Windows.Data.RelativeSource.Self;
b.SetBinding(System.Windows.Controls.Button.ContentProperty, binding);
程序代码使用了和XAML不同的机制,对于每种扩展都会有其特定的代码。在运行时,系统实际上是在被设置了合适值的扩展标记身上调用了ProvideValue方法,程序代码如果也使用这种机制就会变得复杂。ProvideValue定义在MarkupExtension类中,派生类重写这个方法用于对外提供为扩展标记设置的目标属性值(System.Object类型)。
(通过Reflector查看MarkupExtension扩展标记基类,该类包含的ProvideValue是一个抽象方法。在StaticExtension扩展标记类当中,该方法被重写。虽然反射出来的代码比较多,但是大致可以看出,该方法实际上对StaticExtension类的Member属性进行一些内部处理,然后返回处理结果。在上例中,StaticExtension类的Member属性被设置为SystemParameters.IconHeight,系统在处理这个扩展标记时,调用重写的ProvideValue方法,将返回值设置给Button的Height属性。这是XAML的处理方式,但在C#代码中,大可不必如此。 个人感觉这个扩展标记实际上就是XAML中的一种数据绑定方式,简单的绑定如StaticExtension,高级的绑定就需要使用Binding类了。当然也包含作者说的,这个机制也是为了更好地使XAML与.NET对象协作,并且增强了XAML的表现力。)