为Xamarin.Forms ImageButton创建类WinForms Tag/Name的自定义标识属性

1. 创建自定义ImageButton控件类 #

继承Xamarin.Forms原生的ImageButton，通过**可绑定属性（BindableProperty）**实现自定义关联属性，这是Xamarin.Forms控件扩展的标准方式，支持XAML设置、数据绑定等特性：

using Xamarin.Forms;

namespace YourAppNamespace // 替换为你的项目命名空间
{
    public class CustomImageButton : ImageButton
    {
        // 字符串类型的CustomId属性，匹配你示例中的需求
        public static readonly BindableProperty CustomIdProperty =
            BindableProperty.Create(nameof(CustomId), typeof(string), typeof(CustomImageButton), defaultValue: null);

        public string CustomId
        {
            get => (string)GetValue(CustomIdProperty);
            set => SetValue(CustomIdProperty, value);
        }

        // 可选：通用类型的Tag属性，完全复刻WinForms的Tag（支持任意Object类型）
        public static readonly BindableProperty TagProperty =
            BindableProperty.Create(nameof(Tag), typeof(object), typeof(CustomImageButton), defaultValue: null);

        public object Tag
        {
            get => GetValue(TagProperty);
            set => SetValue(TagProperty, value);
        }
    }
}

2. 在XAML中使用自定义控件 #

首先在XAML根元素添加命名空间引用（替换为你的项目命名空间），然后直接使用CustomImageButton并设置自定义属性：

<ContentPage xmlns="http://xamarin.com/schemas/2014/forms"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:local="clr-namespace:YourAppNamespace" <!-- 添加命名空间引用 -->
             x:Class="YourAppNamespace.YourPage">

    <local:CustomImageButton CustomId="BIE Default startup image@0,0,0,0,640,640,100,0,0,640,640,640,640,0@@@0@1"
                             Tag="可存储任意对象/字符串" <!-- 可选属性 -->
                             Source="a"
                             HeightRequest="60"
                             WidthRequest="60"
                             Aspect="AspectFit"
                             BackgroundColor="Transparent"
                             Clicked="ImageButton_Clicked"/>
</ContentPage>

3. 在代码后台访问自定义属性 #

在点击事件或其他业务逻辑中，直接从控件实例获取自定义属性值：

private void ImageButton_Clicked(object sender, EventArgs e)
{
    if (sender is CustomImageButton targetBtn)
    {
        // 获取CustomId
        string customId = targetBtn.CustomId;
        // 获取Tag（如果使用了该属性）
        object tagData = targetBtn.Tag;
        
        // 此处添加你的业务处理逻辑
    }
}

补充说明 #

• AutomationId是专为UI自动化测试设计的属性，官方不推荐用于存储业务关联数据，且其只读特性限制了灵活使用；
• 自定义可绑定属性不仅支持字符串，还可以扩展为任意类型（比如自定义实体类），完全满足类似WinForms Tag的需求。

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