在 ADO.NET 应用程序中添加新数据源(.NET Framework)
注意
数据集和相关类是 2000 年代初的旧 .NET Framework 技术,使应用程序能够在应用程序与数据库断开连接时处理内存中的数据。 它们对于使用户能够修改数据并持续更改回数据库的应用程序特别有用。 虽然数据集已被证明是一项非常成功的技术,但我们建议新的 .NET 应用程序使用 Entity Framework Core。 实体框架提供了一种更自然的方式来将表格数据作为对象模型,并且具有更简单的编程接口。
注意
本文中所述的功能适用于 .NET Framework Windows 窗体和 WPF 开发。 WPF 和 Windows 都不支持将这些功能用于 .NET Core 开发。
在 Visual Studio 中 .NET 数据工具的上下文中,术语“数据源”是指连接到数据存储并为 .NET 应用程序提供数据的 .NET 对象。 在 Visual Studio 设计器可以使用数据源的输出来生成样板代码,当你从“数据源”窗口中拖放数据库对象时,这些代码会将数据绑定到窗体。 此类数据源可以是:
实体框架模型中与某种类型的数据库相关联的类。
与某种数据库关联的数据集。
表示网络服务(如 Windows Communication Foundation (WCF) 数据服务或 REST 服务)的类。
表示 SharePoint 服务的类。
解决方案中的类或集合。
备注
如果不使用数据绑定功能、数据集、实体框架、LINQ to SQL、WCF 或 SharePoint,则“数据源”的概念不适用。 使用 SQLCommand 对象直接连接到数据库,并直接与数据库通信即可。
通过使用数据源配置向导在 Windows 窗体或 Windows Presentation Foundation 应用程序中创建和编辑数据源。 对于实体框架,请首先创建实体类,然后选择“项目”>“新增数据源”以启动向导(本文稍后部分将更详细地介绍)。
“数据源”窗口
创建数据源后,该数据源将显示在“数据源”工具窗口中。
提示
若要打开“数据源”窗口,请确保项目已打开,然后按 Shift+Alt+ D 或选择“查看”>“其他窗口”>“数据源”。
在面向 .NET Framework(而非 .NET Core 或 .NET 5 或更高版本)的 Windows 窗体项目中,可以将数据源从“数据源”窗口拖到窗体设计图面或控件上。 如果拖动表,会获得该表的 BindingNavigator 和 DataGridView。 如果拖动单列,将获得一个 BindingNavigator 以及该列的一个标签以及文本框。 拖动列以获取表的完整数据查看表单。 这些操作会导致生成样板代码,用于显示数据存储中的数据。
下图显示了放到 Windows 窗体上的数据集。 如果在应用程序上选择 F5,则基础数据库中的数据将显示在窗体的控件中。
数据库或数据库文件的数据源
可以创建数据集或实体框架模型,用作数据库或数据库文件的数据源。
数据集
若要创建数据集作为数据源,请通过选择“项目” >“新增数据源”运行数据源配置向导。 选择“数据库”数据源类型,然后按照提示指定新的或现有的数据库连接或数据库文件。
实体类
若要创建实体框架模型作为数据源:
运行实体数据模型向导以创建实体类。 选择“项目”>“新增项”>“ADO.NET 实体数据模型”。
选择要生成模型的方法。
将模型添加为数据源。 选择“对象”类别时,生成的类将显示在数据源配置向导中。
服务的数据源
若要从服务创建数据源,请运行数据源配置向导并选择“服务”数据源类型。 此操作只是打开“添加服务引用”对话框的快捷方式,也可通过在解决方案资源管理器中右键单击项目并选择“添加服务引用”来访问该对话框。
从服务创建数据源时,Visual Studio 向项目添加服务引用。 Visual Studio 还会创建与服务返回的对象对应的代理对象。 例如,返回数据集的服务在项目中表示为数据集;返回特定类型的服务在项目中表示为返回的类型。
可以从以下类型的服务创建数据源:
Web 服务
备注
“数据源”窗口中显示的项取决于该服务返回的数据。 某些服务可能没有为“数据源配置”向导创建可绑定的对象提供足够的信息。 例如,如果该服务返回一个非类型化数据集,则在完成该向导时“数据源”窗口中不会显示任何项。 这是因为非类型化数据集不提供架构,因此向导没有足够的信息来创建数据源。
对象的数据源
可以运行数据源配置向导,然后选择“对象”数据源类型,从公开一个或多个公共属性的任何对象创建数据源。 对象的所有公共属性都显示在“数据源”窗口中。 如果使用实体框架并生成了模型,则在这里可以找到作为应用程序数据源的实体类。
在“选择数据对象”页面上,展开树视图中的节点以找到要绑定到的对象。 树视图包含项目的节点,以及项目引用的程序集和其他项目的节点。
如果想要绑定到未显示在树视图中的程序集或项目中的对象,请单击“添加引用”并使用“添加引用对话框”,以添加对程序集或项目的引用。 添加引用后,程序集或项目将添加到树视图中。
注意
可能需要先生成包含对象的项目,对象才会显示在树视图中。
注意
若要支持拖放数据绑定,实现 ITypedList 或 IListSource 接口的对象必须具有默认构造函数。 否则,Visual Studio 无法对数据源对象进行实例化,并且当你将项目拖到设计图面时,它会显示错误。
SharePoint 列表的数据源
可以通过运行数据源配置向导并选择“SharePoint”数据源类型,从 SharePoint 列表创建数据源。 SharePoint 通过 WCF Data Services 公开数据,因此创建 SharePoint 数据源与从服务创建数据源相同。 在数据源配置向导中选择 SharePoint 项会打开“添加服务引用”对话框,可以在其中通过指向 SharePoint Server,来连接到 SharePoint 数据服务。 此操作需要 SharePoint SDK。
相关内容
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈