.NET MAUI中通过绑定属性向自定义控件传递Action的问题

核心认知误区 #

1. Action作为绑定属性的逻辑错误：Action是引用类型，仅当ViewModel中Action的引用发生变化（如从null变为新实例）时，才会触发控件的propertyChanged回调。若仅调用Invoke()，控件不会收到任何通知。
2. 初始null值导致订阅失败：ViewModel中ShowErrorMsg/ShowSuccessMsg初始为null，绑定后控件的ShowMessageAction也为null，此时无法执行action += ShowMessageAnimation，后续ViewModel调用Invoke()时无响应。
3. 未处理委托订阅的生命周期：即使后续给Action赋值，仅订阅一次新委托，未取消旧委托的订阅，会导致内存泄漏，且重新赋值Action后旧订阅失效。

推荐解决方案 #

方案一：状态属性绑定（最符合MVVM规范） #

通过ViewModel的布尔状态属性驱动控件显示动画，逻辑清晰且无耦合问题。

ViewModel 修改

public class MainViewModel
{
    private bool _isErrorShowing;
    public bool IsErrorShowing
    {
        get => _isErrorShowing;
        set => SetValue(ref _isErrorShowing, value);
    }

    private bool _isSuccessShowing;
    public bool IsSuccessShowing
    {
        get => _isSuccessShowing;
        set => SetValue(ref _isSuccessShowing, value);
    }

    public void SendMessage()
    {
        // 模拟消息发送结果
        bool sendSuccess = true;

        if (sendSuccess)
        {
            IsSuccessShowing = true;
            // 延迟重置状态（或由控件动画结束后自行重置）
            _ = Task.Delay(100).ContinueWith(_ => IsSuccessShowing = false);
        }
        else
        {
            IsErrorShowing = true;
            _ = Task.Delay(100).ContinueWith(_ => IsErrorShowing = false);
        }
    }
}

CustomLabel 修改

public class CustomLabel : Label
{
    public static readonly BindableProperty IsMessageShowingProperty =
        BindableProperty.Create(
            nameof(IsMessageShowing),
            typeof(bool),
            typeof(CustomLabel),
            default(bool),
            propertyChanged: OnIsMessageShowingChanged);

    public bool IsMessageShowing
    {
        get => (bool)GetValue(IsMessageShowingProperty);
        set => SetValue(IsMessageShowingProperty, value);
    }

    private static void OnIsMessageShowingChanged(BindableObject sender, object oldValue, object newValue)
    {
        var label = sender as CustomLabel;
        if ((bool)newValue)
        {
            label.ShowMessageAnimation();
        }
    }

    private async void ShowMessageAnimation()
    {
        IsVisible = true;
        Opacity = 1;

        await Task.Delay(8000);
        await FadeTo(0, 1000);
        IsVisible = false;
        // 重置状态避免重复触发
        IsMessageShowing = false;
    }
}

XAML 绑定

<controls:CustomLabel Text="Error!" TextColor="Red"
                      IsMessageShowing="{Binding IsErrorShowing}" />

<controls:CustomLabel Text="Success!" TextColor="Green"
                      IsMessageShowing="{Binding IsSuccessShowing}" />

方案二：修正Action绑定逻辑（若坚持使用Action） #

需确保ViewModel的Action初始化为空委托，并处理委托的订阅/取消订阅生命周期。

ViewModel 修改

public class MainViewModel
{
    // 初始化为空委托，避免null
    private Action _showErrorMsg = () => { };
    public Action ShowErrorMsg
    {
        get => _showErrorMsg;
        set => SetValue(ref _showErrorMsg, value);
    }

    private Action _showSuccessMsg = () => { };
    public Action ShowSuccessMsg
    {
        get => _showSuccessMsg;
        set => SetValue(ref _showSuccessMsg, value);
    }

    public void SendMessage()
    {
        bool sendSuccess = false;

        if (sendSuccess)
        {
            ShowSuccessMsg?.Invoke();
        }
        else
        {
            ShowErrorMsg?.Invoke();
        }
    }
}

CustomLabel 修改

public class CustomLabel : Label
{
    public static readonly BindableProperty ShowMessageActionProperty =
        BindableProperty.Create(
            nameof(ShowMessageAction),
            typeof(Action),
            typeof(CustomLabel),
            propertyChanged: OnShowMessageChanged);

    public Action ShowMessageAction
    {
        get => (Action)GetValue(ShowMessageActionProperty);
        set => SetValue(ShowMessageActionProperty, value);
    }

    private static void OnShowMessageChanged(BindableObject sender, object oldValue, object newValue)
    {
        var label = sender as CustomLabel;
        // 取消旧委托订阅，防止内存泄漏
        if (oldValue is Action oldAction)
        {
            oldAction -= label.ShowMessageAnimation;
        }
        // 订阅新委托
        if (newValue is Action newAction)
        {
            newAction += label.ShowMessageAnimation;
        }
    }

    private async void ShowMessageAnimation()
    {
        IsVisible = true;
        Opacity = 1;

        await Task.Delay(8000);
        await FadeTo(0, 1000);
        IsVisible = false;
    }
}

方案三：消息传递（适合跨组件通信） #

使用.NET MAUI的WeakReferenceMessenger实现ViewModel与控件的解耦通信。

定义消息类

public class MessageNotification
{
    public bool IsSuccess { get; set; }
}

ViewModel 发送消息

public class MainViewModel
{
    public void SendMessage()
    {
        bool sendSuccess = true;
        WeakReferenceMessenger.Default.Send(new MessageNotification { IsSuccess = sendSuccess });
    }
}

CustomLabel 订阅消息

public class CustomLabel : Label
{
    public static readonly BindableProperty IsSuccessTypeProperty =
        BindableProperty.Create(nameof(IsSuccessType), typeof(bool), typeof(CustomLabel));

    public bool IsSuccessType
    {
        get => (bool)GetValue(IsSuccessTypeProperty);
        set => SetValue(IsSuccessTypeProperty, value);
    }

    public CustomLabel()
    {
        WeakReferenceMessenger.Default.Register<MessageNotification>(this, (recipient, message) =>
        {
            if (message.IsSuccess == IsSuccessType)
            {
                ShowMessageAnimation();
            }
        });
    }

    private async void ShowMessageAnimation()
    {
        IsVisible = true;
        Opacity = 1;

        await Task.Delay(8000);
        await FadeTo(0, 1000);
        IsVisible = false;
    }
}

XAML 使用

<controls:CustomLabel Text="Error!" TextColor="Red"
                      IsSuccessType="False" />

<controls:CustomLabel Text="Success!" TextColor="Green"
                      IsSuccessType="True" />

总结 #

优先选择方案一，它遵循MVVM的状态驱动原则，逻辑清晰，易于维护且无内存泄漏风险。若需跨组件通信，方案三是更好的选择；方案二仅适合必须使用Action的场景，但需注意委托生命周期的管理。

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