TableAdapter 配置向导

项目
09/14/2015

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

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

运行向导

运行该向导以创建或编辑 TableAdapter 及其关联的 DataTable。有关详细信息，请参阅如何：启动 TableAdapter 配置向导。

选择你的数据连接

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

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

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

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

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

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

选择命令类型

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

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

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

使用 SQL 语句

本部分解释了选择**“使用 SQL 语句”选项时完成“TableAdapter 配置向导”**的方式。

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

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

选择要生成的方法

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

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

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

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

备注

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

创建新存储过程

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

在**“生成存储过程”**页面中，输入填充数据表的 SQL 语句。这可以是 TableAdapter 的 SELECT 语句和创建用于选择、更新、插入和删除数据的存储过程的基础。
在**“创建存储过程”**页面中，执行以下操作：
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 高级选项。

生成 Insert、Update 和 Delete 语句

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

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

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

后续步骤

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

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

请参见

通过