“数据适配器预览”对话框

项目
08/12/2011

允许您看到在调用适配器的 SelectCommand 对象时数据是如何填充到数据集中的。使用此对话框允许您测试适配器是否正在返回所需的数据，任何一个表映射是否工作正常，以及在填充数据集时是否出现错误。该对话框还允许您测试向适配器传递不同参数值的效果。

提示

在 Visual Studio 的前一版本中，使用数据适配器在应用程序和数据库之间通信。尽管数据适配器仍是 .NET Framework 数据提供程序 (ADO.NET) 的一个主要组件，TableAdapter 是由设计器生成的组件，这些组件简化了在应用程序与数据库之间操作数据的过程。有关使用 TableAdapter 的更多信息，请参见 TableAdapter 概述。

如果要使用一个数据适配器填充一个数据集而该数据集不是从此适配器直接生成的，则预览数据适配器将会特别有用。

当执行下列任一操作时将出现此对话框：

从**“数据”菜单中选择“预览数据”**。只有在已将数据适配器添加到窗体或组件中后才可以使用此菜单。
单击**“属性”窗口底部的“预览数据”**链接。此链接在显示某一数据适配器的属性时可用。

用户界面元素列表

数据适配器
列出在所使用的窗体或组件中可用的数据适配器。选择想要预览的数据适配器。若要显示使用所有数据适配器的结果，请选择**“<所有数据适配器>”**。
填充数据集
执行此命令并在**“结果”**框中显示数据。

如果在数据适配器将数据填充到数据集的过程中发生错误，则此错误将显示在消息框中。可能的错误包括：
- 数据类型不匹配。
- 正在执行的 SQL 语句或存储过程中存在语法错误。
- 表映射错误。例如，如果将适配器的 MissingMappingAction 或 MissingSchemaAction 属性设置为 Error，以及表映射不能完整描述如何处理数据库和数据集中不匹配的列名，则会引发错误。
- 连接问题。
参数
显示在指定的数据适配器的 SelectCommand 对象中引用的 SQL SELECT 语句或存储过程所需的参数。如果不需要任何参数，则此网格为空白。

每个参数都显示为网格中的一行，其中填充有参数名称和数据类型。在**“值”框中为每个参数输入值。如果参数接受此操作，则还可以从“值”框的下拉列表中选择“<默认>”或“<NULL>”**。
目标数据集
指定使用预览命令向其中填充数据的数据集。您可以从项目中所有可用的数据集中进行选择，也可以选择填充非类型化数据集（即没有架构的数据集）。
数据表
显示数据集中数据表的列表。选择一个表名以查看由数据适配器填充的记录。（通常情况下，每个数据适配器填充数据集中的一个表。）如果已经填充了多个表，则可以在该列表中选择一个表以查看该表的结果。
结果
显示数据集中的数据。此框显示在从数据库返回后并且已应用了所有表映射后数据显示的方式。网格中的数据是只读的。

如果在结果中有多个表，则可以通过在**“数据表”**列表中选择表的名称来查看某个特定表的内容。
清除结果
清除选定表中的所有数据。若要清除所有表，请在**“数据表”列表中选择每个表，然后针对每个表单击“清除结果”**。