Xamarin Forms自定义Pin类数据绑定属性失效问题求助

问题根源分析 #

绑定失效由以下三个核心错误导致：

1. 自定义BindableProperty的Owner类型错误：NameProperty的ownerType被设置为typeof(Pin)，而非自定义的CustomPin，导致绑定系统无法正确识别属性归属。
2. BindingContext设置时机错误：在myUserData的对象初始化器中设置Pin.BindingContext = myUserData时，myUserData尚未完成实例化，实际BindingContext为null，绑定找不到数据源。
3. 数据源未实现INotifyPropertyChanged：UserData未实现该接口，既无法同步初始绑定值，也无法响应后续属性变更。

修复步骤及代码示例 #

1. 修正CustomPin的BindableProperty定义

将NameProperty的ownerType改为typeof(CustomPin)，并使用nameof(Name)替代硬编码字符串避免拼写错误：

public class CustomPin : Pin
{
    public static readonly BindableProperty NameProperty = 
        BindableProperty.Create(nameof(Name), typeof(string), typeof(CustomPin), default(string));

    public string Name
    {
        get { return (string)GetValue(NameProperty); }
        set { SetValue(NameProperty, value); }
    }

    public string Icon { get; set; }
}

2. 让UserData实现INotifyPropertyChanged接口

实现该接口确保绑定能同步初始值及响应后续属性变化：

using System.ComponentModel;
using System.Runtime.CompilerServices;

public class UserData : INotifyPropertyChanged
{
    private string _callsign;
    private string _id;
    private string _team;
    private CustomPin _pin;
    private Position _position;

    public string Callsign
    {
        get => _callsign;
        set
        {
            _callsign = value;
            OnPropertyChanged();
        }
    }

    public string ID
    {
        get => _id;
        set
        {
            _id = value;
            OnPropertyChanged();
        }
    }

    public string Team
    {
        get => _team;
        set
        {
            _team = value;
            OnPropertyChanged();
        }
    }

    public CustomPin Pin
    {
        get => _pin;
        set
        {
            _pin = value;
            OnPropertyChanged();
        }
    }

    public Position Position
    {
        get => _position;
        set
        {
            _position = value;
            OnPropertyChanged();
        }
    }

    public event PropertyChangedEventHandler PropertyChanged;

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

3. 调整初始化与绑定代码

等myUserData完全实例化后再设置BindingContext，避免空引用问题：

// 初始化UserData，暂不设置Pin的BindingContext
public static UserData myUserData = new UserData
{
    Callsign = "User",
    Pin = new CustomPin
    {
        Position = new Position(),
        Name = "",
        Label = ""
    },
    Position = new Position(37.63150086, -122.43626643),
};

// 实例化完成后设置BindingContext并创建绑定
myUserData.Pin.BindingContext = myUserData;
myUserData.Pin.SetBinding(CustomPin.PositionProperty, nameof(UserData.Position));
myUserData.Pin.SetBinding(CustomPin.LabelProperty, nameof(UserData.Callsign));
myUserData.Pin.SetBinding(CustomPin.NameProperty, nameof(UserData.Callsign));

验证修复 #

运行调试代码后，输出会显示正确的绑定结果：

User should be User
User should be User
37.63150086 should be 37.63150086
-122.43626643 should be -122.43626643

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