如何在.NET MAUI Handler中实现类似Xamarin Renderer的属性变更事件

首先修正你自定义Picker中的一处错误：原代码里BindableProperty.Create的第三个参数写成了typeof(CustomEntry)，应该改为typeof(CustomPicker)，否则属性绑定会失效。修正后的自定义Picker代码如下：

public class CustomPicker : Picker
{
    public static readonly BindableProperty DisplayItemTextProperty =
        BindableProperty.Create(nameof(DisplayItemText), typeof(string), typeof(CustomPicker), default(string), BindingMode.TwoWay);

    public string DisplayItemText
    {
        get => (string)GetValue(DisplayItemTextProperty);
        set => SetValue(DisplayItemTextProperty, value);
    }
}

在.NET MAUI中，Handler替代了Xamarin的Renderer机制，要实现原Renderer中OnElementPropertyChanged的逻辑，有两种常用方式：

方式一：使用Mapper映射属性变更（MAUI推荐） #

MAUI的Handler通过Mapper来定义控件属性与原生控件的映射关系，我们可以为自定义的DisplayItemText属性添加映射，自动处理属性变更：

1. 注册自定义Handler
   在MauiProgram.cs中注册CustomPicker对应的Handler：

builder.ConfigureMauiHandlers(handlers =>
{
    handlers.AddHandler<CustomPicker, CustomPickerHandler>();
});

2. 实现CustomPickerHandler

public class CustomPickerHandler : PickerHandler
{
    public CustomPickerHandler() : base(PickerHandler.Mapper)
    {
        // 为DisplayItemText属性添加映射逻辑
        Mapper.AppendToMapping(nameof(CustomPicker.DisplayItemText), (handler, view) =>
        {
            if (handler.PlatformView != null && view is CustomPicker customPicker)
            {
                if (!string.IsNullOrEmpty(customPicker.DisplayItemText))
                {
                    // Android平台的原生控件是Spinner，直接设置Text
                    handler.PlatformView.Text = customPicker.DisplayItemText;
                }
            }
        });
    }

    protected override void ConnectHandler(Android.Widget.Spinner platformView)
    {
        base.ConnectHandler(platformView);
        // 监听原生控件的选中事件，用于更新DisplayItemText
        platformView.ItemSelected += OnItemSelected;
    }

    protected override void DisconnectHandler(Android.Widget.Spinner platformView)
    {
        platformView.ItemSelected -= OnItemSelected;
        base.DisconnectHandler(platformView);
    }

    private void OnItemSelected(object sender, Android.Widget.AdapterView.ItemSelectedEventArgs e)
    {
        if (VirtualView is CustomPicker customPicker && customPicker.Items != null && e.Position >= 0 && e.Position < customPicker.Items.Count)
        {
            // 这里根据你的业务逻辑，将选中项的名称赋值给DisplayItemText
            // 示例：如果Items是自定义模型列表，可转换后获取名称
            // var selectedModel = customPicker.Items[e.Position] as YourModel;
            // customPicker.DisplayItemText = selectedModel.Name;
        }
    }
}

方式二：订阅元素的PropertyChanged事件（接近原Renderer写法） #

如果你更习惯原Renderer中直接监听属性变更的方式，可以在Handler的ConnectHandler方法中订阅CustomPicker的PropertyChanged事件，在事件回调中处理逻辑：

public class CustomPickerHandler : PickerHandler
{
    private CustomPicker _customPicker;

    protected override void ConnectHandler(Android.Widget.Spinner platformView)
    {
        base.ConnectHandler(platformView);
        _customPicker = VirtualView as CustomPicker;
        // 订阅属性变更事件
        _customPicker.PropertyChanged += OnElementPropertyChanged;
        // 监听选中事件
        platformView.ItemSelected += OnItemSelected;
    }

    protected override void DisconnectHandler(Android.Widget.Spinner platformView)
    {
        if (_customPicker != null)
        {
            _customPicker.PropertyChanged -= OnElementPropertyChanged;
        }
        platformView.ItemSelected -= OnItemSelected;
        base.DisconnectHandler(platformView);
    }

    private void OnElementPropertyChanged(object sender, PropertyChangedEventArgs e)
    {
        // 只处理DisplayItemText属性的变更
        if (e.PropertyName == nameof(CustomPicker.DisplayItemText) && PlatformView != null && _customPicker != null)
        {
            if (!string.IsNullOrEmpty(_customPicker.DisplayItemText))
            {
                PlatformView.Text = _customPicker.DisplayItemText;
            }
        }
    }

    private void OnItemSelected(object sender, Android.Widget.AdapterView.ItemSelectedEventArgs e)
    {
        // 同方式一的选中逻辑，更新DisplayItemText
        if (VirtualView is CustomPicker customPicker && customPicker.Items != null && e.Position >= 0 && e.Position < customPicker.Items.Count)
        {
            // 业务逻辑处理
        }
    }
}

注意事项 #

• 上述代码针对Android平台，若需支持iOS，需为iOS平台编写对应的Handler（iOS原生控件为UIPickerView），可通过条件编译或单独的平台项目实现。
• MAUI的Mapper方式更符合框架设计理念，能自动处理属性的初始值设置和后续变更，推荐优先使用。

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