.NET MAUI中如何设置TitleBar/Shell背景为图片或渐变？

问题1：图片背景未生效 #

直接将Shell.Background设为图片路径的方式不正确，因为Shell.Background属性接受的是Brush类型，而非字符串路径，需要用ImageBrush包装图片资源。

修改Resources>Styles>Styles.xaml中的Shell样式：

<ResourceDictionary>
    <Style TargetType="Shell" ApplyToDerivedTypes="True">
        <Setter Property="Shell.Background">
            <Setter.Value>
                <ImageBrush ImageSource="title_bar.png" Stretch="Fill" />
            </Setter.Value>
        </Setter>
        <!-- 其他Setter保持不变 -->
    </Style>
</ResourceDictionary>

注意：确保title_bar.png的生成操作设置为MauiImage，否则无法正确加载资源。

问题2：渐变背景显示白色 #

存在两个关键错误：

1. Shell.BackgroundColor仅接受Color类型，不能直接绑定Brush（渐变属于Brush范畴），应使用Shell.Background属性。
2. Colors.xaml代码开头多了一个闭合标签</ResourceDictionary>，会导致资源加载失败。

步骤1：修正Colors.xaml的渐变定义 #

<ResourceDictionary>
    <!-- 其他颜色资源 -->
    <LinearGradientBrush
        x:Key="TitleBarGradient"
        EndPoint="1,0">
        <GradientStop
            Color="{StaticResource Yellow100Accent}"
            Offset="0.1" />
        <GradientStop
            Color="{StaticResource Blue200Accent}"
            Offset="1.0" />
    </LinearGradientBrush>
</ResourceDictionary>

步骤2：修改Styles.xaml中的Shell样式 #

将Shell.BackgroundColor替换为Shell.Background：

<ResourceDictionary>
    <Style TargetType="Shell" ApplyToDerivedTypes="True">
        <!-- 其他Setter -->
        <Setter Property="Shell.Background" Value="{AppThemeBinding Light={StaticResource TitleBarGradient}, Dark={StaticResource TitleBarGradient}}" />
        <!-- 其他Setter -->
    </Style>
</ResourceDictionary>

以上问题均为对Shell属性类型的误解导致，不属于框架Bug或缺失功能。

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