TableAdapter 查询配置向导

 

**“TableAdapter 查询配置向导”**有助于创建和编辑可添加到 TableAdapter 的其他查询。 TableAdapter 查询可以是任何有效的 SQL 查询,也可以是一个返回数据(返回的数据与 TableAdapter 的关联数据表遵照相同的架构)或标量值的存储过程。 完成该向导后,将向 TableAdapter 添加一个方法,调用该方法可执行查询。 (例如 CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, "Seattle")。)

运行向导

将查询拖动到**“数据集设计器”**上,或配置现有查询(列在第一个查询下的任何查询)。

TableAdapter 中的第一个查询是 TableAdapter 的主查询。 编辑此主查询可打开**“TableAdapter 配置向导”并编辑 TableAdapter 的数据表的架构。 列在主查询下的所有查询均为附加查询,并使用“TableAdapter 查询配置向导”**进行配置。 有关运行该向导的详细信息,请参阅如何:启动 TableAdapter 查询配置向导

选择你的数据连接

从连接列表中选择现有连接,或单击**“新建连接”**,以创建到数据库的连接。

完成**“连接属性”对话框后,“连接详细信息”**区域会显示有关所选提供程序的只读信息以及连接字符串。

将连接字符串保存到应用程序配置文件中

选择**“是,将连接另存为”**将连接字符串存储在应用程序配置文件中。 为连接键入名称或使用提供的默认名称。

将连接字符串保存在应用程序配置文件中可简化数据库连接更改时的应用程序维护过程。 当数据库连接发生更改时,可以在应用程序配置文件中编辑连接字符串。 这样,就不必编辑源代码和重新编译应用程序。 有关在应用程序配置文件中编辑连接字符串的信息,请参阅如何:保存和编辑连接字符串

重要

信息以纯文本格式存储在应用程序配置文件中。 为了减少对敏感信息进行未授权访问的可能性,你可能需要加密数据。 有关详细信息,请参阅Encrypting and Decrypting Data

使用 SQL 语句

本部分阐释了当选中**“使用 SQL 语句”选项时完成“TableAdapter 查询配置向导”**的方式。

选择查询类型

根据应用程序的要求,该向导可创建几种类型的查询。 你可以选择返回数据行(数据表)的 SELECT 查询,也可以选择返回标量值(单个值,如 CountSum)的 SELECT 查询。

在**“选择查询类型”**页面上,选择要从可用查询列表创建的查询类型。

备注

创建 INSERT、UPDATE 或 DELETE 语句不会替换调用 TableAdapter 的 Update 方法时所使用的 TableAdapter 命令。 例如,将 UPDATE 选为查询类型将创建一个新查询,其名称将在向导的后续步骤中指定。 通过调用 TableAdapter 的这一命名方法,可执行此查询。 调用 TableAdapter 的 Update 方法将执行在最初配置 TableAdapter 时所创建的语句。

指定 SQL <Query Type> 语句

在**“指定 SQL 语句”**页面上,键入要在调用该查询时执行的 SQL 语句。

提示

此向导提供了对“查询生成器”的访问权限,查询生成器是一个用于创建 SQL 查询的可视化工具。 若要将其打开,请单击“查询生成器”按钮。

选择要生成的方法

此页面提供了用于选择向导为查询生成哪些方法的选项。

填充 DataTable
创建用于填充数据表的方法。 当调用此方法以使用返回的数据填充数据表时,需要将数据表的名称作为参数进行传递。

另外,你可以在**“方法名称”**框中更改默认名称。 当以代码形式处理此查询时,提供一个有意义的名称会很有帮助。

返回 DataTable
创建用于返回已填充数据表的方法。 在某些应用程序中,更多的是需要返回已填充的数据表,而不是使用数据填充现有数据表。

另外,你可以在**“方法名称”**框中更改默认名称。

选择函数名

键入函数的名称。 创建 TableAdapter 查询会将一个方法添加到具有此处所提供名称的 TableAdapter 中。 调用此方法以执行查询。 当以代码形式处理此查询时,提供一个有意义的名称会很有帮助。

备注

创建新存储过程时,系统会要求你提供两个名称。 第一个名称是在数据库中创建的存储过程的名称;第二个名称是在被调用时执行存储过程的 TableAdapter 上的方法的名称。

创建新存储过程

本部分阐释了当选中**“创建新存储过程”选项时完成“TableAdapter 查询配置向导”**的方式。

  1. 在**“生成存储过程”**页面上,键入要在调用存储过程时执行的 SQL 语句。

    备注

    此向导提供了对“查询生成器”的访问权限,查询生成器是一个用于创建 SQL 查询的可视化工具。 若要将其打开,请单击“查询生成器”按钮。

  2. 在**“创建存储过程”**页面中,执行以下操作:

    1. 为新存储过程键入名称。

    2. 指定是否在基础数据库中创建存储过程。

      备注

      在数据库中创建存储过程的能力由特定数据库的安全设置所决定。

    **“查看向导结果”**页面显示了创建 TableAdapter 查询的结果。 如果向导遇到问题,此屏幕会提供错误信息。

使用现有存储过程

本部分阐释了当选中**“使用现有存储过程”选项时完成“TableAdapter 查询配置向导”**的方式。

  1. 从该向导的**“选择现有存储过程”**页面上的下拉列表中选择现有存储过程。

    会显示选定存储过程的**“参数”“结果”**以供参考。

  2. 单击**“下一步”**。

选择由存储过程返回的数据的形式

由选定存储过程返回的数据类型决定该向导创建 TableAdapter 方法的方式。

选择由此查询返回的数据类型。

  • 选择**“表格数据”可打开“选择要生成的方法”**页面(请参阅此帮助页前面的说明),该页面允许你指定方法类型、方法名称以及要创建的分页支持。

  • 选择**“单个值”创建返回单个值的类型化方法。 此选项可打开“选择函数名”**页面(请参阅此帮助页前面的说明)。

  • 选择**“没有值”创建执行存储过程但不期望返回数据的类型化方法。 此选项可打开“选择函数名”**页面(请参阅此帮助页前面的说明)。

查看向导结果

**“查看向导结果”**页面显示了创建 TableAdapter 查询的结果。 如果该向导遇到问题,则会在此页面上显示详细信息。

请参阅

TableAdapter 概述
如何:编辑 TableAdapter 查询
数据演练
在 Visual Studio 中将 Windows 窗体控件绑定到数据
Visual Studio 的数据应用程序概述
连接到 Visual Studio 中的数据
准备应用程序以接收数据
将数据获取到应用程序
在 Visual Studio 中将控件绑定到数据
在应用程序中编辑数据
验证数据
保存数据