Xamarin Forms为所有按钮加效果遇ControlTemplateProperty解析错误

这个问题我之前也碰到过，核心原因其实很直白：Xamarin.Forms的原生Button控件根本没有ControlTemplate属性。ControlTemplate是为那些带有可替换内容区域的控件设计的（比如ContentView、ContentPage、Frame这类），Button不属于这类控件，所以直接给它设置ControlTemplate肯定会报错。

结合你的需求——给所有按钮添加ShadowEffect，我给你两种解决方案，按需选择：

方案一：直接在Button的Style中添加Effect（推荐） #

既然你的核心需求是全局给按钮加阴影，完全不需要绕ControlTemplate这个弯路，直接在Button的Style里设置Effects属性就可以了，代码更简洁，也不会有报错：

<ResourceDictionary>
  <Style TargetType="{x:Type Button}">
    <Setter Property="Effects">
      <Setter.Value>
        <effects:ShadowEffect Radius="5" DistanceX="5" DistanceY="5">
          <effects:ShadowEffect.Color>
            <OnPlatform x:TypeArguments="Color">
              <On Platform="iOS" Value="Black" />
              <On Platform="Android" Value="White" />
              <On Platform="UWP" Value="Red" />
            </OnPlatform>
          </effects:ShadowEffect.Color>
        </effects:ShadowEffect>
      </Setter.Value>
    </Setter>
  </Style>
</ResourceDictionary>

这样写就能全局给所有Button应用你定义的ShadowEffect，完美达成你的需求。

方案二：自定义支持ControlTemplate的Button（适合复杂布局场景） #

如果你是因为有其他复杂的布局需求，必须使用ControlTemplate，那可以自己封装一个支持该属性的自定义按钮：

1. 先写自定义控件的C#逻辑 #

using Xamarin.Forms;

namespace YourAppNamespace.Controls
{
    public class CustomButton : ContentView
    {
        // 暴露Button常用的Text属性
        public static readonly BindableProperty TextProperty = BindableProperty.Create(
            nameof(Text), typeof(string), typeof(CustomButton), string.Empty);

        // 暴露Command属性，支持绑定命令
        public static readonly BindableProperty CommandProperty = BindableProperty.Create(
            nameof(Command), typeof(ICommand), typeof(CustomButton));

        public string Text
        {
            get => (string)GetValue(TextProperty);
            set => SetValue(TextProperty, value);
        }

        public ICommand Command
        {
            get => (ICommand)GetValue(CommandProperty);
            set => SetValue(CommandProperty, value);
        }
    }
}

2. 在ResourceDictionary中定义ControlTemplate和Style #

<ResourceDictionary
    xmlns="http://xamarin.com/schemas/2014/forms"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
    xmlns:controls="clr-namespace:YourAppNamespace.Controls"
    xmlns:effects="clr-namespace:YourAppNamespace.Effects">

  <ControlTemplate x:Key="CustomButtonTemplate" >
    <Grid RowSpacing="0" VerticalOptions="FillAndExpand" HorizontalOptions="FillAndExpand">
      <Button Text="{TemplateBinding Text}" 
              Command="{TemplateBinding Command}"
              VerticalOptions="FillAndExpand"
              HorizontalOptions="FillAndExpand">
        <Button.Effects>
          <effects:ShadowEffect Radius="5" DistanceX="5" DistanceY="5">
            <effects:ShadowEffect.Color>
              <OnPlatform x:TypeArguments="Color">
                <On Platform="iOS" Value="Black" />
                <On Platform="Android" Value="White" />
                <On Platform="UWP" Value="Red" />
              </OnPlatform>
            </effects:ShadowEffect.Color>
          </effects:ShadowEffect>
        </Button.Effects>
      </Button>
    </Grid>
  </ControlTemplate>

  <Style TargetType="{x:Type controls:CustomButton}">
    <Setter Property="ControlTemplate" Value="{StaticResource CustomButtonTemplate}"></Setter>
  </Style>
</ResourceDictionary>

3. 在页面中使用自定义按钮 #

把原来的<Button>替换成你自定义的控件：

<controls:CustomButton Text="测试按钮" Command="{Binding YourCommand}" />

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