binding-in-a-control-template.md

在控件模板中绑定

当您创建控件模板并希望绑定到模板的父级时，可以使用：

<TextBlock Name="tb" Text="{TemplateBinding Caption}"/>

<!-- 也能写成这样 -->
<TextBlock Name="tb" Text="{Binding Caption, RelativeSource={RelativeSource TemplatedParent}}"/>

尽管这里展示的两种语法在大多数情况下是等效的，但也存在一些差异：

1. TemplateBinding只接受单个属性而不是属性路径，因此如果要使用属性路径进行绑定，则必须使用第二种语法：

   <!-- 这不起作用，因为TemplateBinding只接受单个属性 -->
   <TextBlock Name="tb" Text="{TemplateBinding Caption.Length}"/>
   
   <!-- 在这种情况下，必须使用此语法 -->
   <TextBlock Name="tb" Text="{Binding Caption.Length, RelativeSource={RelativeSource TemplatedParent}}"/>
   

2. 出于性能原因，TemplateBinding仅支持单向绑定(OneWay)（这与WPF相同）。这意味着TemplateBinding实际上等同于{Binding RelativeSource={RelativeSource TemplatedParent}, Mode=OneWay}。如果控件模板中需要双向绑定(TwoWay)，则需要完整的语法，如下所示。注意，与TemplateBinding不同，Binding也将使用默认绑定模式。

   {Binding RelativeSource={RelativeSource TemplatedParent}, Mode=TwoWay}
   

3. TemplateBinding只能用于IStyledElement.

   <!-- 这不起作用，因为GeometryDrawing不是IStyledElement -->
   <GeometryDrawing Brush="{TemplateBinding Foreground}"/>
   
   <!-- 在这种情况下，必须使用此语法 -->
   <GeometryDrawing Brush="{Binding Foreground, RelativeSource={RelativeSource TemplatedParent}}"/>