C# Windows Forms 数据绑定（DataBinding）简易实现

山海之间

发布时间：2026-10-13| 4人浏览过

原创

了解如何通过 C# 的 DataBinding 机制将业务对象属性自动映射到 UI 控件，无需频繁编写冗余的代码即可实现界面数据的实时展示与更新。

数据绑定的核心原理

在 C# Windows Forms (WinForms) 开发中，数据绑定允许我们将 UI 控件的属性（如 TextBox 的 Text）直接关联到一个业务对象的属性。这样当源数据发生变化时，可以通过特定方式通知界面刷新，或者从界面读取最新值回传给对象，从而减少样板代码。

实现步骤与代码解析

第1步：定义业务模型并实例化

首先需要一个包含属性的类作为数据源。在实际项目中通常是数据库实体或 DTO，此处使用一个简单的 Order 类示例进行演示。在窗体加载时实例化该对象，赋予初始值。

第2步：配置控件绑定关系

利用 DataBindings.Add() 方法建立连接。语法结构为：
control.DataBindings.Add("ControlProperty", dataSource, "DataMember")。
其中：

"ControlProperty"：指控件需绑定的具体属性（例如 "Text"）。
dataSource：数据源对象实例。
"DataMember"：对象上对应的属性名（例如 "Id"）。

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Windows.Forms;
namespace AppForm
{
 public partial class Form3 : Form
 {
  Order order = null;
  public Form3()
  {
   InitializeComponent();
   // 1. 实例化业务对象并赋值
   order = new Order()\n   {\n    Id = 1,\n    Customer = "123",\n    OrderDate = DateTime.Now\n   };\n   InitUI(); // 2. 执行绑定初始化
  }

  // 3. 设置绑定关系
  void InitUI()
  {
   // 绑定 TextBox1 到 order.Id
   textBox1.DataBindings.Add(new Binding("Text", order, "Id"));
   // 绑定 TextBox2 到 order.Customer
   textBox2.DataBindings.Add(new Binding("Text", order, "Customer"));
   // 绑定 TextBox3 到 order.OrderDate
   textBox3.DataBindings.Add(new Binding("Text", order, "OrderDate"));
  }

  // 辅助方法：强制读取当前对象值并写入控件
  void UpdateUI()
  {
   // 注意：实际应用中更建议使用 BindingContext 或 INotifyPropertyChanged
   // 这里演示原稿中的手动读取刷新逻辑
   if(textBox1.DataBindings.Count > 0)
      textBox1.DataBindings[0].ReadValue();
   if(textBox2.DataBindings.Count > 0)
      textBox2.DataBindings[0].ReadValue();
   if(textBox3.DataBindings.Count > 0)
      textBox3.DataBindings[0].ReadValue();
  }

  private void button1_Click(object sender, EventArgs e)
  {
   // 模拟业务逻辑修改数据
   order.Id = 2;
   order.Customer = "456";
   order.OrderDate = DateTime.Now;
   
   // 触发界面更新
   UpdateUI();
  }
 }
}