如何在.NET MAUI中从设置页即时修改主页网格背景色？

直接跨页面访问控件是不推荐的，不仅耦合度高，还容易因为页面实例管理问题导致失败。下面提供两种可靠的即时生效方案，同时保留重启后生效的功能：

方案1：使用WeakReferenceMessenger（推荐，低耦合） #

这是.NET MAUI官方推荐的消息传递方式，用于跨页面/组件通信。

步骤1：定义消息类 #

创建一个携带颜色信息的消息类，用来传递背景色变更通知：

using CommunityToolkit.Mvvm.Messaging;
using Microsoft.Maui.Graphics;

public class BackgroundColorChangedMessage : ValueChangedMessage<Color>
{
    public BackgroundColorChangedMessage(Color value) : base(value)
    {
    }
}

注意：需要安装CommunityToolkit.Mvvm NuGet包，这是.NET MAUI常用的MVVM工具包

步骤2：在主页注册消息接收 #

在MainPage.xaml.cs中注册消息，收到通知后立即修改网格背景色，同时更新Preferences：

using CommunityToolkit.Mvvm.Messaging;
using Microsoft.Maui.Graphics;

public partial class MainPage : ContentPage
{
    public MainPage()
    {
        InitializeComponent();
        
        // 注册消息监听
        WeakReferenceMessenger.Default.Register<BackgroundColorChangedMessage>(this, (recipient, message) =>
        {
            // 假设你的网格控件x:Name为MainGrid
            MainGrid.BackgroundColor = message.Value;
            // 同步保存到Preferences，确保重启后生效
            Preferences.Set("GridBackgroundColor", message.Value.ToHex());
        });
    }
}

步骤3：在设置页发送消息 #

当用户在设置页选择颜色后，发送消息通知主页更新：

using CommunityToolkit.Mvvm.Messaging;
using Microsoft.Maui.Graphics;

public partial class SettingsPage : ContentPage
{
    private void OnColorChanged(object sender, EventArgs e)
    {
        // 假设使用ColorPicker控件，获取选中的颜色
        if (sender is ColorPicker picker && picker.Color is Color selectedColor)
        {
            // 发送消息
            WeakReferenceMessenger.Default.Send(new BackgroundColorChangedMessage(selectedColor));
        }
    }
}

方案2：使用共享状态服务（MVVM友好） #

通过依赖注入创建一个全局共享的设置服务，用数据绑定实现即时更新，更符合MVVM设计模式。

步骤1：创建全局设置服务 #

实现INotifyPropertyChanged，让属性变更能通知UI更新：

using System.ComponentModel;
using System.Runtime.CompilerServices;
using Microsoft.Maui.Graphics;

public class AppSettingsService : INotifyPropertyChanged
{
    private Color _gridBackgroundColor;

    public Color GridBackgroundColor
    {
        get => _gridBackgroundColor;
        set
        {
            if (_gridBackgroundColor != value)
            {
                _gridBackgroundColor = value;
                OnPropertyChanged();
                // 保存到Preferences
                Preferences.Set("GridBackgroundColor", value.ToHex());
            }
        }
    }

    public AppSettingsService()
    {
        // 初始化时从Preferences读取已保存的颜色
        var savedHex = Preferences.Get("GridBackgroundColor", "#FFFFFF");
        _gridBackgroundColor = Color.FromArgb(savedHex);
    }

    public event PropertyChangedEventHandler PropertyChanged;

    protected void OnPropertyChanged([CallerMemberName] string propertyName = null)
    {
        PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
    }
}

步骤2：注册服务到依赖注入容器 #

在MauiProgram.cs中注册这个服务为单例，确保全局只有一个实例：

public static MauiApp CreateMauiApp()
{
    var builder = MauiApp.CreateBuilder();
    builder
        .UseMauiApp<App>()
        .ConfigureFonts(fonts =>
        {
            fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
        });

    // 注册全局设置服务
    builder.Services.AddSingleton<AppSettingsService>();

    return builder.Build();
}

步骤3：主页绑定服务属性 #

在MainPage.xaml中，将网格的BackgroundColor绑定到服务的属性：

<Grid x:Name="MainGrid" BackgroundColor="{Binding GridBackgroundColor}">
    <!-- 主页内容 -->
</Grid>

然后在MainPage.xaml.cs中注入服务并设置绑定上下文：

public partial class MainPage : ContentPage
{
    public MainPage(AppSettingsService settingsService)
    {
        InitializeComponent();
        BindingContext = settingsService;
    }
}

步骤4：设置页修改服务属性 #

在设置页注入服务，直接修改属性即可触发主页UI更新：

public partial class SettingsPage : ContentPage
{
    private readonly AppSettingsService _settingsService;

    public SettingsPage(AppSettingsService settingsService)
    {
        InitializeComponent();
        _settingsService = settingsService;
    }

    private void OnColorPickerSelectedColorChanged(object sender, ColorChangedEventArgs e)
    {
        _settingsService.GridBackgroundColor = e.NewColor;
    }
}

为什么直接访问主页控件会失败？ #

因为页面实例由导航栈管理，你在设置页中直接引用的MainPage可能不是当前显示的实例，或者还未被初始化，导致空引用或无效操作。上述两种方案都避免了直接耦合页面实例，更符合.NET MAUI的设计规范。

内容的提问来源于stack exchange，提问作者Sh.sh94