数据适配器配置向导
更新:2007 年 11 月
“数据适配器配置向导”用于设置新的或现有数据适配器的属性。数据适配器包含可由应用程序用于将数据从数据库读入数据集并将其写回数据库的 SQL 命令。向导还可以创建数据连接,使适配器可以与数据库进行通信。
配置数据适配器是在应用程序中使用数据集时所涉及的若干步骤之一。运行该向导之后,您还需要单独向应用程序中添加数据集,并编写代码以提供一种使数据适配器可以使用数据集的方法。
说明: |
---|
在 Visual Studio 的前一版本中,使用数据适配器在应用程序和数据库之间通信。尽管数据适配器仍是 .NET Framework 数据提供程序 (ADO.NET)的一个主要组件,TableAdapter 是由设计器生成的组件,这些组件简化了在应用程序与数据库之间操作数据的过程。有关使用 TableAdapter 的更多信息,请参见 TableAdapter 概述。 |
运行向导
可以运行向导以创建新的适配器或编辑现有适配器。也可以针对现有数据适配器运行向导以更改适配器的属性。
运行向导
执行下列操作之一:
如果要创建新的适配器,将数据适配器对象从工具箱拖到窗体或组件上。
如果编辑现有适配器,则在窗体或组件中选择该适配器,然后在上下文菜单上选择“配置数据适配器”。
向导启动。
指定连接和 SQL 命令信息。向导显示若干对话框来帮助您完成此项工作:
如果要创建连接,则向导将显示“添加/修改连接”对话框(通用)的“连接”选项卡,允许您为此连接指定提供程序、服务器名、数据库名、用户名和密码。
为帮助您创建 SQL 语句,向导提供一个“查询生成器”,它是一个实用工具,允许您使用可视化工具创建并测试 Select 语句。若要启动此查询生成器,请在需要 SQL 语句时单击“查询生成器”按钮。有关更多信息,请参见查询和视图设计器工具。
提示: 如果指定要创建存储过程,请单击“预览 SQL 脚本”查看向导用来创建存储过程的脚本。可以复制该脚本并修改之以创建您自己的过程。
说明: 如果在向导中单击“取消”,仍会创建适配器,但不设置其属性。可以在“属性”窗口手动设置其属性,也可以再次运行向导。
向导执行的操作
“数据适配器配置向导”引导您完成创建数据适配器(必要时还创建数据连接)的整个过程。此向导将完成以下任务:
创建适配器。
如有必要,创建数据连接,并对适配器进行设置以使其可以使用此连接。
创建用于读取和写入数据的 SQL 语句或存储过程。
创建并配置 SQL 语句或存储过程的参数,以使这些命令读取和写入正确的数据。
在数据库和数据集之间映射表和列名。
配置命令对象
向导的主要工作就是配置四个数据命令对象,适配器使用这四个对象与数据库之间进行数据传递。这些对象包括 SelectCommand 对象,以及可选的 UpdateCommand、InsertCommand 和 DeleteCommand 对象。其中每一个对象都包含用于读取和写入数据的 SQL 语句或存储过程名。其中的每一个命令的属性(尤其是 CommandText 属性)都根据您在向导中所做的选择进行设置。
向导允许您使用 SQL 语句或命令的存储过程。它为您提供以下选项:
使用 SQL 语句。可以指定 Select 语句,并且如果您选择创建这些语句,则向导将根据您在 Select 语句中包括的内容生成相应的 Update、Insert 和 Delete 语句。Update 和 Insert 语句包括用于传递新值的参数。Update、Insert 和 Delete 语句在 WHERE 子句中包括用于在数据库中定位正确记录的参数。
创建新存储过程。该选项类似于使用语句的情形,只是向导生成存储过程而不是语句。由于存储过程可能比 SQL 语句速度快,因此您可能会出于性能上的考虑而选择该选项。选择该选项后,向导对这四个命令均生成存储过程,当然仍然要根据您在 Select 命令中指定的内容而定。您可以选择将新的存储过程写入到数据库中。如果没有这样做,您仍可以捕获到向导用于创建存储过程的 SQL 脚本,并可以在稍后自己执行该脚本。
使用现有存储过程。选择该选项后,您要为四个命令中的每一个选取存储过程。向导将显示可以在数据库中找到的存储过程的名称和详细信息。如果您已经具有执行这四种数据库操作的存储过程,则使用该选项将非常有用。
高级向导选项
该向导为您提供了一些高级选项,允许您控制为数据适配器创建 Update、Insert 和 Delete 命令的方式。您可以通过单击“高级选项”在向导的“生成 SQL 语句”窗格中显示“高级 SQL 生成选项”对话框。
此对话框允许您指定以下选项:
生成 Insert、Update 和 Delete 语句。指示数据适配器将根据 Select 语句生成用于将数据写入数据库的其他语句或存储过程。如果适配器将仅用于读取数据而不对其进行更新,则清除此复选框可以使代码效率更高。
使用开放式并发。指示希望向导包括用于测试某一记录自从被从数据库中读取以来是否已更改的逻辑。
刷新数据集。指示希望向导生成在更新某一记录之后从数据库中重新读取该记录的代码。这将为您提供某一记录经过刷新后的视图,包括由数据库插入的值,如默认值和自动增加的值。
有关更多信息,请参见“高级 SQL 生成选项”对话框。
后续步骤
完成向导后,数据适配器(可能还有连接)就添加窗体中。此后,您可能还要执行许多步骤。某些步骤几乎总是要执行,而另一些步骤则是可选的。
可能需要的步骤
以下是在完成数据适配器配置向导之后经常要执行的一些步骤:
添加更多的数据适配器。向导仅创建一个数据适配器。每个数据适配器通常用于在单个数据表中读取和写入数据。如果您有意使用包含多个表的数据集,则您可能希望向窗体或组件中添加更多的数据适配器。每次从工具箱中添加数据适配器时,都要重新运行向导以配置这个特定的数据适配器。
更改适配器的表映射。默认情况下,适配器假定将在具有相同名称的表和列中进行读写。但您可能使用适配器从具有某个名称的数据库读入具有另一个名称的数据集中。或从数据库中读取的列可能比数据集中需要的列多。有关如何更改这些设置的信息,请参见如何:将数据源列映射到数据集数据表列。
预览适配器将填充到数据集中的数据。有关更多信息,请参见如何:预览数据适配器的结果。
添加用于填充数据集的逻辑。若要使用数据适配器填充数据集,则需要调用适配器的 Fill 方法。这将执行适配器的 SelectCommand 对象中的命令,并将结果填充到数据集中。有关更多信息,请参见 从 DataAdapter 填充数据集 (ADO.NET)。