TableAdapter 配置向导

项目
08/12/2011

**“TableAdapter 配置向导”**创建并编辑 TableAdapter。该向导根据输入的 SQL 语句或数据库中的现有存储过程来创建 TableAdapter。该向导还可以根据输入到向导中的 SQL 语句在数据库中创建新的存储过程。

TableAdapter 连接数据库，针对数据库执行查询或存储过程，并使用查询或存储过程返回的数据填充 DataTable。除了可以使用数据填充现有的数据表，TableAdapter 还可以返回填充了数据的新数据表。有关更多信息，请参见 TableAdapter 概述。

运行向导

运行向导可以创建或编辑 TableAdapter 以及与 TableAdapter 关联的 DataTable。有关更多信息，请参见如何：启动 TableAdapter 配置向导。

选择数据连接

从连接列表中选择现有连接，或单击**“新建连接”**，打开“添加/修改连接”对话框（通用）并创建到数据库的连接。

完成**“连接属性”对话框时，“连接详细信息”**区域会显示关于所选提供程序的只读信息和连接字符串。

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

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

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

安全说明
信息以纯文本格式保存在应用程序配置文件中。为了减少对敏感信息进行未授权访问的可能性，您可能需要加密数据。有关更多信息，请参见加密和解密数据。

选择命令类型

选择要对数据库执行何种类型的命令。

在**“选择命令类型”**页上，选择以下从数据库提取数据的方法：

通过**“使用 SQL 语句”**可以键入 SQL 语句以从数据库中选择数据。
“创建新存储过程”：选择此选项可使向导根据指定的 SELECT 语句创建新的存储过程（在数据库中）。
“使用现有存储过程”：选择此选项可将数据库中已经存在的存储过程映射到 TableAdapter 的 SELECT、INSERT、UPDATE 和 DELETE 命令。

使用 SQL 语句

本节解释选择了**“使用 SQL 语句”选项时如何完成“TableAdapter 配置向导”**。

在**“生成 SQL 语句”**页上，键入执行时会使用数据填充数据表的 SQL 语句。

提示

此向导提供对“查询生成器”的访问，查询生成器是一个用于创建 SQL 查询的可视化工具。若要将其打开，请单击“查询生成器”按钮。有关使用“查询生成器”的更多信息，请参见查询和视图设计器工具。

**“查看向导结果”**页显示创建 TableAdapter 的结果。如果向导遇到任何问题，此页会提供错误信息。

选择要生成的方法

此页提供选项，用于选择向导为获取和更新数据而生成的 TableAdapter 方法。

填充 DataTable
创建 TableAdapter 用于填充数据表的默认方法。调用此方法时，将数据表的名称作为参数传递。

另外，您可以在**“方法名称”**框中更改默认名称。
返回 DataTable
创建 TableAdapter 用于返回已填充的数据表的方法。在某些应用程序中，更多的是需要返回已填充了数据的数据表，而不是使用数据填充现有数据表。

另外，您可以在**“方法名称”**框中更改默认名称。
创建方法以将更新直接发送到数据库
创建将更改写入基础数据库所必需的 INSERT、UPDATE 和 DELETE 命令。选择此框与将 GenerateDBDirectMethods 属性设置为 true 是等价的。

提示

当原始 SQL 语句未提供足够的信息或查询不是可更新的查询时，此选项不可用。例如，JOIN 查询和返回单个值（标量）的查询中可能会出现这种情况。

创建新存储过程

本节解释选择**“创建新存储过程”选项时如何完成“TableAdapter 配置向导”**。

在**“生成存储过程”**页中，输入填充数据表的 SQL 语句。这可以是 TableAdapter 的 SELECT 语句和创建用于选择、更新、插入和删除数据的存储过程的基础。

提示

此向导提供对“查询生成器”的访问，查询生成器是一个用于创建 SQL 查询的可视化工具。若要将其打开，请单击“查询生成器”按钮。有关使用“查询生成器”的更多信息，请参见查询和视图设计器工具或在该对话框中按 F1 键。
在**“创建存储过程”**页中，执行下面的操作：
1. 键入新存储过程的名称。
2. 指定是否在基础数据库中创建存储过程。
  
  提示
  
  在数据库中创建存储过程的能力由特定数据库的安全设置和权限确定。例如，如果您不具有在数据库中创建新存储过程的权限，则不可以完成此选项。
**“查看向导结果”**页显示创建 TableAdapter 的结果。如果向导遇到任何问题，此页会提供错误信息。

使用现有存储过程

本节解释选择**“使用现有存储过程”选项时如何完成“TableAdapter 配置向导”**。

将命令绑定到现有存储过程

选择要为 TableAdapter 的**“SELECT”、“INSERT”、“UPDATE”和“DELETE”命令执行的存储过程。执行这些存储过程的时间为在 TableAdapter 上调用关联方法时。例如，分配给“Update”**命令的存储过程在调用 TableAdapter.Update() 方法时执行。

将参数从选中的存储过程映射到数据表中相应的列。例如，如果存储过程接受一个传递到表中 CompanyName 列的名为 @CompanyName 的参数，则将 @CompanyName 参数的**“源列”**设置为 CompanyName。

提示

分配给 SELECT 命令的存储过程通过调用您在向导的下一步中指定的 TableAdapter 的方法执行。默认值为 Fill，因此执行 SELECT 过程的典型代码为 TableAdapter.Fill(tableName)。如果将默认值“Fill”更改为其他值，则将 Fill 替换为指定的名称，并将“TableAdapter”替换为 TableAdapter 的实际名称（例如，CustomersTableAdapter）。

高级选项

单击**“高级选项”**可访问下面的 TableAdapter 高级选项。有关更多信息，请参见 “高级 SQL 生成选项”对话框。

生成 Insert、Update 和 Delete 语句

选择此选项时，向导将根据在**“生成 SQL 语句”**页上定义的 SELECT 语句尝试生成 INSERT、UPDATE 和 DELETE 语句。
使用开放式并发

选择此选项会修改 UPDATE 和 DELETE 语句，以检测各个记录自最初读入数据表以来是否已修改。检测到并发冲突时会引发异常。
刷新 DataTable

选择此选项会在执行 INSERT 和 UPDATE 语句后刷新表中的数据。

后续步骤

在完成向导之后，会向数据集添加 TableAdapter，并可在数据集设计器中查看和编辑该 TableAdapter。此后，您可能还要执行许多步骤。

添加更多 TableAdapter。向导创建一个 TableAdapter。如果您想要使用包含多个表的数据集，可能会希望向数据集中添加更多 TableAdapter。
向 TableAdapter 添加其他查询。有关更多信息，请参见如何：创建 TableAdapter 查询。
在 “数据源”窗口中查看此数据集并将项拖动到窗体上以创建数据绑定控件。有关更多信息，请参见在 Visual Studio 中将 Windows 窗体控件绑定到数据。

请参见