演练:创建支持复杂数据绑定的 Windows 窗体用户控件
发布日期: 2016年7月
在 Windows 应用程序的窗体上显示数据时,你可以从**“工具箱”**中选择现有的控件,而当标准控件无法提供应用程序所要求的功能时,你还可以创作自定义控件。 本演练显示了如何创建实现 ComplexBindingPropertiesAttribute 的控件。 实现 ComplexBindingPropertiesAttribute 的控件包含可以绑定到数据的 DataSource
和 DataMember
属性。 此类控件类似于 DataGridView 或 ListBox。
有关控件创作的详细信息,请参阅设计时开发 Windows 窗体控件。
创建用于数据绑定方案的控件时,你需要实现以下数据绑定特性之一:
数据绑定特性的用法 |
---|
在简单控件上实现 DefaultBindingPropertyAttribute(如 TextBox),此类控件用于显示数据的单个列(或属性)。 有关详细信息,请参阅演练:创建支持简单数据绑定的 Windows 窗体用户控件。 |
在控件上实现 ComplexBindingPropertiesAttribute(如 DataGridView),此类控件用于显示数据列表(或表)。 (本演练页面描述了此过程)。 |
在控件上实现 LookupBindingPropertiesAttribute(如 ComboBox),此类控件用于显示数据列表(或表),也需要显示数据的单个列或属性。 有关详细信息,请参阅演练:创建支持查找数据绑定的 Windows 窗体用户控件。 |
本演练创建显示表中多行数据的复杂控件。 本示例使用源自 Northwind 示例数据库的 Customers
表。 复杂用户控件将会在自定义控件中的 DataGridView 中显示 Customers 表。
在本演练中,你将学会如何执行以下任务:
创建新的**“Windows 应用程序”**。
将新的**“用户控件”**添加到你的项目中。
以可视方式设计用户控件。
实现
ComplexBindingProperty
特性。使用数据源配置向导创建数据集。
在“数据源”窗口中设置**“Customers”**表,以使用新的复杂控件。
通过将新控件从**“数据源窗口”拖到“Form1”**上来添加新控件。
系统必备
若要完成本演练,你将需要:
- 能够访问 Northwind 示例数据库。 有关详细信息,请参阅如何:安装示例数据库。
创建 Windows 应用程序
第一步是创建**“Windows 应用程序”**。
创建新的 Windows 项目
在 Visual Studio 中,从**“文件”菜单创建一个新的“项目”**。
将项目命名为 ComplexControlWalkthrough。
选择**“Windows 应用程序”,然后单击“确定”**。 有关详细信息,请参阅客户端应用程序。
**“ComplexControlWalkthrough”项目即被创建并添加到“解决方案资源管理器”**中。
将用户控件添加到项目中
由于本演练是从**“用户控件”创建复杂的可绑定数据控件,所以你必须将“用户控件”**项添加到项目中。
将用户控件添加到项目中
从**“项目”菜单中,选择“添加用户控件”**。
在**“名称”区域中键入“ComplexDataGridView”,然后单击“添加”**。
**“ComplexDataGridView”控件将会添加到“解决方案资源管理器”**中,并在设计器中打开该控件。
设计 ComplexDataGridView 控件
此步骤将 DataGridView 添加到该用户控件。
设计 ComplexDataGridView 控件
- 将 DataGridView 从**“工具箱”**拖到该用户控件的设计图面上。
添加所需的数据绑定特性
对于支持数据绑定的复杂控件,你可以实现 ComplexBindingPropertiesAttribute。
实现 ComplexBindingProperties 特性
将**“ComplexDataGridView”控件切换到代码视图。 (在“视图”菜单上,选择“代码”**。)
将
ComplexDataGridView
中的代码替换为以下内容:using System.Windows.Forms; namespace CS { [System.ComponentModel.ComplexBindingProperties("DataSource", "DataMember")] public partial class ComplexDataGridView : UserControl { public object DataSource { get{ return dataGridView1.DataSource; } set{ dataGridView1.DataSource = value; } } public string DataMember { get{ return dataGridView1.DataMember; } set{ dataGridView1.DataMember = value; } } public ComplexDataGridView() { InitializeComponent(); } } }
<System.ComponentModel.ComplexBindingProperties("DataSource", "DataMember")> Public Class ComplexDataGridView Public Property DataSource() As Object Get Return DataGridView1.DataSource End Get Set(ByVal value As Object) DataGridView1.DataSource = value End Set End Property Public Property DataMember() As String Get Return DataGridView1.DataMember End Get Set(ByVal value As String) DataGridView1.DataMember = value End Set End Property End Class
从**“生成”菜单中选择“生成解决方案”**。
从数据库创建数据源
此步骤根据 Northwind 示例数据库中的 Customers
表,使用**“数据源配置向导”**创建数据源。 你必须具有对 Northwind 示例数据库的访问权限,才能创建连接。 有关设置 Northwind 示例数据库的信息,请参阅如何:安装示例数据库。
创建数据源
在**“数据”菜单上,单击“显示数据源”**。
在**“数据源”窗口中,选择“添加新数据源”以启动“数据源配置向导”**。
在**“选择数据源类型”页上选择“数据库”,然后单击“下一步”**。
在**“选择你的数据连接”**页面上,执行以下操作之一:
如果下拉列表中包含到 Northwind 示例数据库的数据连接,请选择该连接。
- 或 -
选择**“新建连接”,以启动“添加/修改连接”**对话框。
如果数据库需要密码,请选择该选项以包括敏感数据,再单击**“下一步”**。
在**“将连接字符串保存到应用程序配置文件”页面上单击“下一步”**。
在**“选择数据库对象”页面上展开“表”**节点。
选择
Customers
表,然后单击**“完成”**。**“NorthwindDataSet”即被添加到你的项目中,并且“数据源”**窗口中将显示
Customers
表。
设置 Customers 表以使用 ComplexDataGridView 控件
在**“数据源”**窗口中,你可以先设置要创建的控件,然后再将项拖动到窗体上。
设置 Customers 表以绑定到 ComplexDataGridView 控件
在设计器中打开**“Form1”**。
在**“数据源”窗口中展开“Customers”**节点。
单击**“Customers”节点上的下拉箭头,然后选择“自定义”**。
在**“数据 UI 自定义选项”对话框中,从“关联的控件”列表中选择“ComplexDataGridView”**。
单击
Customers
表上的下拉箭头,然后从控件列表中选择**“ComplexDataGridView”**。
将控件添加到窗体
通过将某些项从**“数据源”**窗口拖到你的窗体上,可创建数据绑定控件。
在窗体上创建数据绑定控件
- 将主**“Customers”节点从“数据源”窗口中拖到窗体上,并验证“ComplexDataGridView”**控件是否用于显示表中的数据。
运行应用程序
运行应用程序
- 按 F5 运行该应用程序。
后续步骤
根据应用程序的要求,在创建了支持数据绑定的控件后,还可能需要执行一些步骤。 接下来的一些常见步骤包括:
将你的自定义控件置于控件库中,以便在其他应用程序中重用它们。
创建支持查找方案的控件。 有关详细信息,请参阅演练:创建支持查找数据绑定的 Windows 窗体用户控件。
请参阅
设置从“数据源”窗口中拖动时要创建的控件
Windows 窗体控件
在 Visual Studio 中将 Windows 窗体控件绑定到数据
连接到 Visual Studio 中的数据
准备应用程序以接收数据
将数据获取到应用程序
在 Visual Studio 中将控件绑定到数据
在应用程序中编辑数据
验证数据
保存数据