IRONSOFTWAREHOME

通过Tim Corey(锦标赛查看器)解释WinForms数据绑定

C# App Start To Finish Lesson 22 - Tournament Viewer Part 1

Tim Corey

1h 11m 40s

简介

在C# App From Start to Finish系列的第22课中,Tim Corey开始着手Tournament Viewer表单,高度关注WinForms数据绑定。 Tim解释说,这节课不是关于将数据保存到数据库或文本文件——那将稍后进行。 相反,这个视频的全部目的是连接UI、填充控件,以及理解数据如何通过模型和WinForms控件之间的移动并使用数据绑定。

Tim明确表示,WinForms数据绑定有时会显得笨拙、困惑且有时令人沮丧。 因此,这课成为对数据绑定实际行为、打破它的原因以及如何修复它的深刻实用的走查。 通过跟随Tim的调试过程,我们获得了关于WinForms绑定机制的现实和有价值的理解。

锦标赛查看器表单概述

Tim开始描述锦标赛查看器表单应该做什么。 表单显示:

  • 锦标赛名称

  • 包含锦标赛回合的下拉菜单

  • 显示所选回合比赛的列表框

  • 所选比赛的队名和比分

蒂姆强调,所有信息必须保持同步。 当一个回合改变时,比赛必须更新。 当一个比赛改变时,队名和比分必须更新。 这一要求推动了关于数据绑定的整个讨论。 绑定到同一数据源的控件(也称为数据绑定控件)会自动保持同步。 BindingNavigator 控件通过保持记录列表中的当前项指针来处理数据的绑定。 CurrencyManager 类管理列表控件与数据源对象之间的绑定集合,允许位置跟踪和变更通知。 每个绑定控件,例如 TextBox 或 Label,通过这些机制链接到数据源,以确保自动同步。

将锦标赛对象传递到表单

蒂姆解释说,锦标赛查看器表单不应该决定加载哪个锦标赛。 这项责任属于仪表板。 因此,锦标赛查看器表单必须通过其构造函数接收一个 TournamentModel。

他展示了如何在表单级别存储传递进来的锦标赛对象,使其对表单中的每个方法都可访问。 这个锦标赛对象成为所有数据绑定操作的单一真相来源。 在简单数据绑定中,控件可以绑定到单个数据元素,例如单个数据表中的一个值,允许您显示或编辑个别数据点。 BindingSource 可以用于简单和复杂的绑定场景。

加载表单数据方法

蒂姆介绍了一个名为 LoadFormData 的私有方法。 该方法从锦标赛模型中提取数据并将其推送到 UI 控件。

例如:

  • 锦标赛名称标签直接从 tournament.TournamentName 获取其值。 这涉及到将控件的属性(如文本框控件的文本属性)设置为数据源中的一个值。

蒂姆指出,这是最简单的数据绑定形式——手动分配值——是处理列表和集合之前的一个很好的起点。 简单绑定连接控件的一个属性到数据源中的一个值,通常每次显示一条记录。

连接仪表板按钮

蒂姆演示了如何修改仪表板,以便当用户选择一个锦标赛并点击"加载锦标赛"时,锦标赛查看器表单会打开。

这里,蒂姆将所选的下拉项转换为 TournamentModel 并传递到查看器表单中。 他通过运行应用程序并看到锦标赛名称正确出现来确认连接工作。

这证实,在进入列表绑定之前,基本对象传递和 UI 更新是正常运行的。

将回合加载到下拉菜单中

现在,蒂姆开始列表绑定,从锦标赛回合开始。

他解释说,回合最好表示为整数列表,而不是字符串。 蒂姆明确表示,这种选择使事情变得更简单,因为:

  • 整数可以干净地绑定到下拉菜单

  • 整数可以无需字符串解析即可检索

  • 选择的值可以直接转换回整数

ComboBox 控件可以绑定到给定的表或列表,使您能够高效地显示和选择数据。 绑定 ComboBox 控件时,您可以使用 DisplayMember 属性指定向用户显示的字段,并使用 ValueMember 属性确定用作基础值的字段。 同样,您可以将 DataGridView 控件绑定到数据表中包含的信息。

蒂姆遍历锦标赛的回合,提取唯一的回合编号,并将它们存储在一个列表中。

通过数据绑定连接回合下拉菜单

蒂姆介绍了第一个重要的 WinForms 绑定规则:

在重设 DataSource 之前总是设为空。

他清除下拉菜单的数据源,然后将回合列表分配给它。 当您将控件绑定到数据源时,如果数据源实现了像 INotifyCollectionChanged 这样的接口,控件将在数据更改时自动刷新其 UI。 这确保了数据与其可视化表示之间的实时同步。 此外,UI 控件或基础数据源中的变化会自动根据配置(一对一或双向)更新绑定的另一端。 由于整数自然转换为字符串,他解释这里不需要 DisplayMember。

然后蒂姆演示了一个常见的错误——忘记调用加载方法——并展示了缺少单个方法调用如何导致空的下拉菜单。

SelectedIndexChanged 事件和动态更新

蒂姆解释说,WinForms 很大程度上依赖事件,特别是 SelectedIndexChanged。

他将回合下拉菜单的 SelectedIndexChanged 事件连接到一个加载所选回合的比赛的方法。 在 WinForms 数据绑定中,事件处理程序接收对象发送者参数,它标识触发事件的控件。 您可以处理以下事件,例如格式化和解析,以自定义数据格式和验证; Binding 类的格式和解析事件允许在数据绑定过程中对数据进行特殊格式化和验证。 其他控件也可以通过类似的事件处理进行绑定和同步。

蒂姆更喜欢将逻辑提取到私有辅助方法中,而不是直接在事件处理程序中放置代码。 他解释这样保持代码的可重用性和清洁。

基于所选回合加载比赛

蒂姆通过将下拉菜单的选定项转换回整数来检索所选回合。

他再次遍历锦标赛的回合,但这次过滤比赛,使比赛回合等于所选回合。 这些比赛被放入一个所选比赛列表中,成为比赛列表框的数据源。

这引入了绑定复杂对象列表的挑战。

创建显示属性用于绑定

蒂姆解释说,比赛模型没有适合 UI 显示的天然字符串表示。

蒂姆没有强迫逻辑到 UI 中,而是在模型中添加了一个只读的 DisplayName 属性。 此属性构建一个字符串,如:

队 A 对队 B
Text

如果缺少一个队(再见周或未来回合),蒂姆返回:

比赛尚未确定
Text

复杂绑定控件,如 DataGridView,支持复杂绑定场景,可以显示和编辑来自数据表或其他结构的多个数据元素。 复杂数据绑定允许您将多个数据元素绑定到控件,例如从基础记录源绑定多列或行。 ADO.NET 提供了许多适合绑定的数据结构,包括 DataTable、DataView 和其他结构,Windows 窗体支持绑定到多个数据源。 绑定类管理数据源字段和控件属性之间的逻辑链接,接口如 IBindingList、IEditableObject 和 INotifyPropertyChanged 提供排序、更改通知和回滚支持。 您可以在数据视图上设置默认过滤器来控制数据的显示方式,绑定上下文和 CurrencyManager 最终决定了数据绑定控件如何同步。 Windows 窗体的 BindingContext 属性管理表单的 CurrencyManager 对象,每个数据源都有一个 CurrencyManager 对象,保持所有绑定到相同数据源的控件同步。 可以在 Windows 窗体中创建自定义控件,通过实现必要的数据绑定接口,使其表现得像标准数据绑定控件。

这是蒂姆强调的一个关键的 WinForms 数据绑定原则:

模型应该决定如何显示——而不是 UI。

调试绑定错误

蒂姆遇到多个错误:

  • 第二回合显示不正确

  • 比赛没有刷新

  • 事件意外触发

蒂姆没有隐藏这些问题,而是逐步演示调试步骤。他解释了更换列表时绑定会如何断开,即使新列表包含有效数据。

这导致了一个关键的 WinForms 教训。

下面的代码展示了如何处理 Binding 类的格式和解析事件,在数据绑定过程中提供特殊的格式化和验证。 格式事件和解析事件可用于自定义数据在 UI 和数据源之间的转换和验证方式。

Windows 窗体数据绑定中的 BindingSource 与 BindingList

蒂姆试验了 BindingSource,将其放置在 UI 控件与数据之间。 他解释这是以前推荐的方法,但承认它增加了复杂性和困惑。 BindingSource 组件作为数据源和 Windows 窗体控件之间的代理,并且适用于多种适合绑定的数据结构,例如 DataTables、DataViews、BindingLists 和数组。

然后,他介绍了 BindingList,解释它会在列表更改时自动更新绑定控件。 如果数据源实现了适当的接口,如 INotifyCollectionChanged,Windows 窗体中的数据绑定支持在基础数据更改时自动更新控件。

然而,蒂姆发现了一个关键规则:

绝不能用新列表替换 BindingList。

相反,您必须:

  • 清除现有的 BindingList

  • 将项目重新添加到其中

替换列表会打破绑定连接。

通过清空列表修复破损的绑定

蒂姆确认绑定问题的根本原因:

  • 分配新的 BindingList() 会断开UI连接

  • 清空并重新添加项目可以保留绑定

他更新回合和比赛以使用这种模式。 一旦一致应用,UI 最终正确更新。

手动加载初始选择

蒂姆解释 WinForms 在加载项目时不会自动触发 SelectedIndexChanged。

为了修复此问题,他手动:

  • 在加载回合后加载第 1 回合比赛

  • 编程选择第一个比赛

这确保了 UI 初始化正确,无需用户交互。

最终结果和课程总结

在课程结束时,蒂姆确认:

  • 回合正确更新

  • 比赛正确更新

  • 队名和比分加载正常

  • 再见周和未来回合显示有意义的文本

他强调,这堂课不是关于完美,而是关于理解 WinForms 数据绑定的实际行为——包括其局限性。

蒂姆总结时解释,计分和过滤(如"仅未玩")将在下一堂课中处理,一旦有真实的状态变化。

结束思考

第 22 课是一堂实际的 WinForms 数据绑定大师班,不是因为一切运行顺利,而是蒂姆·科里在实时演示每一次失败、修复和设计决定。

通过观看蒂姆的视频,开发者可以获得以下内容的现实理解:

  • 为何 WinForms 绑定感觉脆弱

  • BindingList 如何工作

  • 为何清空列表重要

  • UI 和模型应该如何交互

如果您曾经对 WinForms 数据绑定感到困惑,这次课程——以及蒂姆的解释——终于让"为什么"豁然开朗。

Earn More by Sharing What You Love

Do you create content for developers working with .NET, C#, Java, Python, or Node.js? Turn your expertise into extra income!

Let's Stay in Touch!

Join our newsletter, you’ll get exclusive access on article updates. We value your privacy

Key in blue circle

立即获取免费的 30 天试用版密钥

Your trial license will be sent to your email address

无任何限制。100% 解锁。无需信用卡。

bullet_checked无需信用卡或创建账户无任何限制。100% 解锁。无需信用卡。
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
获取您的无义务咨询
填写下面的表格或通过sales@ironsoftware.com
您的资料将始终保密。
深受全球数百万工程师信赖
Iron Software 的客户徽标
立即获取您的免费30 天试用密钥
无需信用卡或创建账户