SqlCommandBuilder 类

自动生成单表命令，用于将对 DataSet 所做的更改与关联的 SQL Server 数据库的更改相协调。无法继承此类。

命名空间:System.Data.SqlClient

程序集:System.Data（在 system.data.dll 中）


语法



Visual Basic（声明）

Public NotInheritable Class SqlCommandBuilder

Inherits DbCommandBuilder

Visual Basic（用法）

Dim instance As SqlCommandBuilder

C#

public sealed class SqlCommandBuilder : DbCommandBuilder

C++

public ref class SqlCommandBuilder sealed : public DbCommandBuilder

J#

public final class SqlCommandBuilder extends DbCommandBuilder

JScript

public final class SqlCommandBuilder extends DbCommandBuilder

备注



SqlDataAdapter 不会自动生成实现 DataSet 的更改与关联的 SQL Server 实例之间的协调所需的 Transact-SQL 语句。但是，如果设置了 SqlDataAdapter 的 SelectCommand 属性，则可以创建一个 SqlCommandBuilder 对象来自动生成用于单表更新的 Transact-SQL 语句。然后，SqlCommandBuilder 将生成其他任何未设置的 Transact-SQL 语句。

每当设置了 DataAdapter 属性，SqlCommandBuilder 就将其本身注册为 RowUpdating 事件的侦听器。一次只能将一个 SqlDataAdapter 与一个 SqlCommandBuilder 对象（或相反）互相关联。

为了生成 INSERT、UPDATE 或 DELETE 语句，SqlCommandBuilder 会自动使用 SelectCommand 属性来检索所需的元数据集。如果在检索到元数据后（例如在第一次更新后）更改 SelectCommand，则应调用 RefreshSchema 方法来更新元数据。

SelectCommand 还必须至少返回一个主键列或唯一的列。如果什么都没有返回，就会产生 InvalidOperation 异常，不生成命令。

SqlCommandBuilder 还使用由 SelectCommand 引用的 Connection、CommandTimeout 和 Transaction 属性。如果修改了这些属性中的一个或多个，或者替换了 SelectCommand 本身，用户则应调用 RefreshSchema。否则，InsertCommand、UpdateCommand 和 DeleteCommand 属性都保留它们以前的值。

如果调用 Dispose，则会解除 SqlCommandBuilder 与 SqlDataAdapter 的关联，并且不再使用生成的命令。


示例



下面的示例结合 SqlDataAdapter 和 SqlConnection，使用 SqlCommand 从数据源中选择行。向该示例传递了一个连接字符串、一个查询字符串（它是一个 Transact-SQL SELECT 语句）和一个数据库表名称字符串。然后该示例创建一个 SqlCommandBuilder。

Visual Basic


复制代码

Private Function SelectSqlRows(ByVal connectionString As String, _

ByVal queryString As String, ByVal tableName As String) As DataSet

Using connection As New SqlConnection(connectionString)

Dim adapter As New SqlDataAdapter()

adapter.SelectCommand = New SqlCommand(queryString, connection)

Dim builder As SqlCommandBuilder = New SqlCommandBuilder(adapter)

connection.Open()

Dim dataSet As DataSet = New DataSet

adapter.Fill(dataSet, tableName)

' Code to modify data in DataSet here

' Without the SqlCommandBuilder this line would fail.

adapter.Update(dataSet, tableName)

Return dataSet

End Using

End Function

C#


复制代码

public static DataSet SelectSqlRows(string connectionString,

string queryString, string tableName)

{

using (SqlConnection connection = new SqlConnection(connectionString))

{

SqlDataAdapter adapter = new SqlDataAdapter();

adapter.SelectCommand = new SqlCommand(queryString, connection);

SqlCommandBuilder builder = new SqlCommandBuilder(adapter);

connection.Open();

DataSet dataSet = new DataSet();

adapter.Fill(dataSet, tableName);

//code to modify data in DataSet here

//Without the SqlCommandBuilder this line would fail

adapter.Update(dataSet, tableName);

return dataSet;

}

}