问题：使用ResourceDictionary样式无法修改Button的BackgroundColor

问题重现 #

在App.xaml中定义Button样式尝试修改BackgroundColor，但应用到页面Button后未达到预期效果：

App.xaml代码：

<Application.Resources>
    <ResourceDictionary>
        <Color x:Key="WarningButtonBackGroundColor">#eb8916</Color>
        
        <Style x:Key="WarningButtonStyle" TargetType="Button">
            <Setter Property="BackgroundColor" Value="{StaticResource WarningButtonBackGroundColor}"></Setter>
        </Style>

    </ResourceDictionary>
</Application.Resources>

页面XAML代码：

<Button Text="Delete" Style="{StaticResource WarningButtonStyle}"></Button>

原因分析 #

1. 属性兼容性问题：Xamarin.Forms 5.0及以上版本中，Button的BackgroundColor属性已被Background属性取代（虽有兼容，但优先使用Background更可靠），而Background需要的是Brush类型而非直接的Color。
2. 视觉状态覆盖：Button默认的视觉状态（如Normal、Pressed、Disabled）会定义不同状态下的背景色，直接设置属性可能被这些状态样式覆盖。

解决方案 #

方案1：改用Background属性并使用SolidColorBrush #

修改App.xaml中的样式，将BackgroundColor替换为Background，并将Color包装为SolidColorBrush：

<Application.Resources>
    <ResourceDictionary>
        <Color x:Key="WarningButtonBackGroundColor">#eb8916</Color>
        
        <Style x:Key="WarningButtonStyle" TargetType="Button">
            <Setter Property="Background">
                <Setter.Value>
                    <SolidColorBrush Color="{StaticResource WarningButtonBackGroundColor}" />
                </Setter.Value>
            </Setter>
        </Style>

    </ResourceDictionary>
</Application.Resources>

或者直接定义Brush资源：

<Application.Resources>
    <ResourceDictionary>
        <SolidColorBrush x:Key="WarningButtonBackgroundBrush" Color="#eb8916" />
        
        <Style x:Key="WarningButtonStyle" TargetType="Button">
            <Setter Property="Background" Value="{StaticResource WarningButtonBackgroundBrush}" />
        </Style>

    </ResourceDictionary>
</Application.Resources>

方案2：修改视觉状态确保样式生效 #

如果Button的视觉状态覆盖了背景色，可在样式中显式定义各状态的背景色：

<Application.Resources>
    <ResourceDictionary>
        <Color x:Key="WarningButtonBackGroundColor">#eb8916</Color>
        <Color x:Key="WarningButtonPressedColor">#d97a12</Color>
        
        <Style x:Key="WarningButtonStyle" TargetType="Button">
            <Setter Property="VisualStateManager.VisualStateGroups">
                <VisualStateGroupList>
                    <VisualStateGroup x:Name="CommonStates">
                        <VisualState x:Name="Normal">
                            <VisualState.Setters>
                                <Setter Property="Background" Value="{StaticResource WarningButtonBackGroundColor}" />
                            </VisualState.Setters>
                        </VisualState>
                        <VisualState x:Name="Pressed">
                            <VisualState.Setters>
                                <Setter Property="Background" Value="{StaticResource WarningButtonPressedColor}" />
                            </VisualState.Setters>
                        </VisualState>
                        <VisualState x:Name="Disabled">
                            <VisualState.Setters>
                                <Setter Property="Background" Value="#cccccc" />
                            </VisualState.Setters>
                        </VisualState>
                    </VisualStateGroup>
                </VisualStateGroupList>
            </Setter>
        </Style>

    </ResourceDictionary>
</Application.Resources>

这样无论Button处于哪种状态，背景色都会按定义显示。

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