如何创建可在Xamarin.Forms中实现数据绑定的C#类

嘿，作为刚入门XAML和C#数据绑定的新手，你踩的这个坑其实特别常见！我来帮你捋清楚INotifyPropertyChanged的正确打开方式，还有你可能忽略的细节~

第一步：写出正确的Customer类实现 #

很多新手会在属性setter或者通知方法上出错，这是触发绑定更新的核心。这里给你一个规范的实现：

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

public class Customer : INotifyPropertyChanged
{
    // 私有字段存储属性值
    private string _phoneNumber;

    // 公开属性供绑定使用
    public string PhoneNumber
    {
        get => _phoneNumber;
        set
        {
            // 先判断值是否真的改变，避免无意义的通知
            if (_phoneNumber == value) return;
            
            _phoneNumber = value;
            // 自动获取当前属性名，避免拼写错误
            OnPropertyChanged();
        }
    }

    // 必须实现的PropertyChanged事件
    public event PropertyChangedEventHandler PropertyChanged;

    // 封装通知逻辑，方便所有属性复用
    protected virtual void OnPropertyChanged([CallerMemberName] string propertyName = null)
    {
        // 用空值判断避免空引用异常
        PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
    }
}

这里的关键细节：

• 用[CallerMemberName]特性自动获取属性名，不用手动写字符串，彻底避免拼写错误
• 在setter里先判断值是否变化，减少不必要的通知
• 正确实现PropertyChanged事件和触发逻辑

第二步：XAML里的绑定配置不能少 #

光有类还不够，XAML里得让控件找到你的Customer实例，并且正确绑定属性：

<!-- 以WPF窗口为例，先设置DataContext作为数据源 -->
<Window x:Class="YourAppName.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:local="clr-namespace:YourAppName"
        Title="数据绑定示例" Height="300" Width="400">
    <!-- 把Customer实例设为窗口的数据源 -->
    <Window.DataContext>
        <local:Customer />
    </Window.DataContext>
    
    <StackPanel Margin="20">
        <!-- 单向绑定到PhoneNumber属性，默认模式就是OneWay，不用特意写 -->
        <TextBlock Text="{Binding PhoneNumber}" FontSize="16" Margin="0 0 0 10"/>
        <!-- 点击按钮触发更新 -->
        <Button Content="设置电话号码" Click="SetPhoneNumber_Click" Padding="8 4"/>
    </StackPanel>
</Window>

第三步：按钮点击的正确逻辑 #

后台代码里要正确获取Customer实例，然后更新属性：

private void SetPhoneNumber_Click(object sender, RoutedEventArgs e)
{
    // 从DataContext里拿到Customer对象
    if (DataContext is Customer customer)
    {
        // 更新属性，这时候setter会自动触发PropertyChanged通知
        customer.PhoneNumber = "138-XXXX-XXXX";
    }
}

最容易踩的几个坑 #

你可以对照检查一下自己的代码：

• 忘记设置DataContext：控件找不到数据源，绑定自然不会生效
• PropertyChanged事件没正确实现：比如忘记定义事件，或者OnPropertyChanged方法写错了参数
• 手动写属性名拼写错误：比如把PhoneNumber写成PhoneNum，用[CallerMemberName]就能避开这个问题
• 绑定模式选错：如果不小心写成OneTime，那只会绑定初始值，后续更新不会同步

按照上面的步骤调整后，点击按钮应该就能看到TextBlock里的电话号码自动更新啦！刚开始学数据绑定的时候容易忽略这些细节，多试几次就熟练了~

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