如何在XAML中为ControlTemplate资源控件传递参数？

现有复用代码 #

我现在把Button封装在ControlTemplate资源里实现复用，代码如下：

<Grid.Resources>
   <ControlTemplate x:Key="GenericButton">
       <Button Text="Click Here"
                IsEnabled="{Binding ViewModelProperty,
                           Converter={StaticResource IsNotNullConverter}}" />
   </ControlTemplate>
</Grid.Resources>

目前通过ContentView引用这个模板，只要硬编码ViewModel属性名就能正常工作：

<VerticalStackLayout Padding="20" Spacing="20" VerticalOptions="Fill">
   <ContentView ControlTemplate="{StaticResource GenericButton}" />
</VerticalStackLayout>

期望的动态用法 #

我希望能给模板传递参数，指定要绑定的ViewModel属性名，用法类似这样：

<ContentView ControlTemplate="{StaticResource GenericButton, Parameter=ViewModelProperty}" />

对应的模板代码改成接收传递的参数：

<ControlTemplate x:Key="GenericButton">
   <Button Text="Click Here"
            IsEnabled="{Binding PassedViewModelPropertyParameter,
                       Converter={StaticResource IsNotNullConverter}}" />
</ControlTemplate>

问题解答 #

这个概念叫什么？

这种给ControlTemplate传递外部参数、实现模板动态绑定的机制，在XAML系列框架（MAUI/WPF/UWP等）里叫做参数化ControlTemplate，核心是通过模板绑定（TemplateBinding）或相对绑定（RelativeSource）实现模板与宿主控件的数据交互，本质是让模板能根据宿主的配置动态调整绑定目标。

具体实现步骤（以MAUI为例）

这里提供两种常用实现方式，按需选择：

方式一：使用附加属性传递参数

1. 定义附加属性：在项目中创建静态类存放传递参数的附加属性

namespace YourAppNamespace; // 替换为你的项目命名空间

public static class TemplateParams
{
    // 定义用于传递启用状态绑定路径的附加属性
    public static readonly BindableProperty EnabledBindPathProperty =
        BindableProperty.CreateAttached(
            "EnabledBindPath",
            typeof(string),
            typeof(TemplateParams),
            string.Empty);

    public static string GetEnabledBindPath(BindableObject view)
    {
        return (string)view.GetValue(EnabledBindPathProperty);
    }

    public static void SetEnabledBindPath(BindableObject view, string value)
    {
        view.SetValue(EnabledBindPathProperty, value);
    }
}

2. 修改ControlTemplate：通过RelativeSource找到宿主ContentView，获取附加属性值并动态绑定

<!-- 先在XAML头部声明命名空间：xmlns:local="clr-namespace:YourAppNamespace" -->
<Grid.Resources>
    <ControlTemplate x:Key="GenericButton">
        <Button Text="Click Here">
            <Button.IsEnabled>
                <Binding 
                    Path="{Binding Source={RelativeSource TemplatedParent}, Path=(local:TemplateParams.EnabledBindPath)}"
                    Converter="{StaticResource IsNotNullConverter}"
                    Mode="OneWay" />
            </Button.IsEnabled>
        </Button>
    </ControlTemplate>
</Grid.Resources>

3. 使用时传递参数：在ContentView上设置附加属性，指定要绑定的ViewModel属性名

<VerticalStackLayout Padding="20" Spacing="20" VerticalOptions="Fill">
    <ContentView 
        ControlTemplate="{StaticResource GenericButton}"
        local:TemplateParams.EnabledBindPath="ViewModelProperty" />
</VerticalStackLayout>

方式二：自定义ContentView宿主控件

如果觉得附加属性不够直观，可以创建自定义ContentView承载模板参数：

1. 自定义宿主控件：

namespace YourAppNamespace;

public class ButtonHostView : ContentView
{
    public static readonly BindableProperty EnabledBindPathProperty =
        BindableProperty.Create(
            nameof(EnabledBindPath),
            typeof(string),
            typeof(ButtonHostView),
            string.Empty);

    public string EnabledBindPath
    {
        get => (string)GetValue(EnabledBindPathProperty);
        set => SetValue(EnabledBindPathProperty, value);
    }
}

2. 修改ControlTemplate：绑定到自定义控件的依赖属性

<Grid.Resources>
    <ControlTemplate x:Key="GenericButton">
        <Button Text="Click Here"
                IsEnabled="{Binding EnabledBindPath, Source={RelativeSource TemplatedParent}, Converter={StaticResource IsNotNullConverter}}" />
    </ControlTemplate>
</Grid.Resources>

3. 使用自定义控件：

<VerticalStackLayout Padding="20" Spacing="20" VerticalOptions="Fill">
    <local:ButtonHostView 
        ControlTemplate="{StaticResource GenericButton}"
        EnabledBindPath="ViewModelProperty" />
</VerticalStackLayout>

内容的提问来源于stack exchange，提问作者usefulBee