如何：手动创建和配置数据适配器

更新：2007 年 11 月

可以在不使用向导的情况下创建数据适配器。无论创建适配器的方式如何，总可以对它进行配置更改。

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

说明：
显示的对话框和菜单命令可能会与“帮助”中的描述不同，具体取决于您的当前设置或版本。若要更改设置，请在“工具”菜单上选择“导入和导出设置”。有关更多信息，请参见 Visual Studio 设置。

默认情况下，Visual Studio 中关闭了对数据适配器的设计时支持。若要支持数据适配器，您必须将其添加到“工具箱”中，如下面的第一个步骤所述。

右击“工具箱”并选择“选择项”。
从“选择工具箱项”对话框中的“.NET Framework 组件”选项卡选择要添加的项。例如，要使用“用于 SQL Server 的 .NET Framework 数据提供程序”，请选择“SqlDataAdapter”、“SqlConnection”和“SqlCommand”。
单击“确定”将所选的项添加到“工具箱”。

确保正在操作的窗体或组件有可用的连接对象。有关添加独立连接的详细信息，请参见建立连接 (ADO.NET)。
从“工具箱”的“数据”选项卡中，将 OleDbDataAdapter、SqlDataAdapter、OdbcDataAdapter 或 OracleDataAdapter 对象拖到设计图面上。

设计器将向窗体或组件添加适配器的一个实例，并启动“数据适配器配置向导”。
关闭向导。

选择适配器，然后在“属性”窗口中配置用于读取和更新数据的命令。必须配置 SelectCommand 对象。如果适配器将用于更新数据源，则还必须配置 UpdateCommand、DeleteCommand 和 InsertCommand 对象。

为每个命令对象设置下列属性。

属性	说明
ActiveConnection	设置以引用连接对象。可以在“属性”窗口中从“ActiveConnection”属性创建连接对象。通常，每个命令对象将引用相同的连接对象，但如果应用程序需要，可以选择每个命令使用不同的连接。
CommandText	SQL 语句的文本或存储过程的名称。对于某些提供程序，可以在 CommandText 属性中包含多个语句或存储过程名称，以分号 (;) 分隔。这些语句或存储过程按顺序执行。这在类似下面的情况下很有用：在更新或 INSERT 语句之后发出一条 SELECT 语句以取回已刷新记录和任何自动生成的值（如默认值或自动增加的值）。
CommandType	一个值，该值指示应怎样解释 CommandText 属性的值： Text - 此命令为一个 SQL 语句。 StoredProcedure - 此命令是对存储过程的引用。 TableDirect - 此文本不是一个命令，而是表的名称。
Parameters	Parameter 类型的对象的集合，配置这些对象以向命令传递值。在 SelectCommand 对象中，仅当命令包含参数占位符时才创建参数集合。UpdateCommand、InsertCommand 和 DeleteCommand 对象始终需要参数。有关详细信息，请参见如何：配置数据适配器的参数。

如果不希望数据源和数据集内的列名相同，请更改映射。MissingMappingAction 属性的默认值 (Passthrough) 将自动在数据源和数据集内生成相同的名称。有关更多信息，请参见如何：将数据源列映射到数据集数据表列。
从“数据”菜单中选择“生成数据集”。

提示：

如果未看到“数据”菜单，请单击窗体或组件设计器中的任意位置；仅当设计器具有焦点时该菜单才出现。
如果想要查看数据适配器填充数据集的方式，请预览结果。有关更多信息，请参见如何：预览数据适配器的结果。