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