SqlCommandBuilder 类

定义

public ref class SqlCommandBuilder sealed : System::Data::Common::DbCommandBuilder

public ref class SqlCommandBuilder sealed : System::ComponentModel::Component

public sealed class SqlCommandBuilder : System.Data.Common.DbCommandBuilder

public sealed class SqlCommandBuilder : System.ComponentModel.Component

type SqlCommandBuilder = class
    inherit DbCommandBuilder

type SqlCommandBuilder = class
    inherit Component

Public NotInheritable Class SqlCommandBuilder
Inherits DbCommandBuilder

Public NotInheritable Class SqlCommandBuilder
Inherits Component

继承

Object

MarshalByRefObject

Component

DbCommandBuilder

SqlCommandBuilder

继承

Object

MarshalByRefObject

Component

SqlCommandBuilder

示例

以下示例使用 SqlCommand、 和 SqlDataAdapterSqlConnection从数据源中选择行。 向该示例传递连接字符串、作为 Transact-SQL SELECT 语句的查询字符串，以及作为数据库表名称的字符串。 然后，该示例创建一个 SqlCommandBuilder。

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

        builder.GetUpdateCommand();

        //Without the SqlCommandBuilder this line would fail
        adapter.Update(dataSet, tableName);

        return dataSet;
    }
}

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 New SqlCommandBuilder(adapter)

        connection.Open()

        Dim dataSet As New DataSet()
        adapter.Fill(dataSet, tableName)

        ' Code to modify data in DataSet here 

        builder.GetUpdateCommand()

        ' Without the SqlCommandBuilder this line would fail.
        adapter.Update(dataSet, tableName)

        Return dataSet
    End Using
End Function

注解

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

每当设置 属性时， DataAdapter 会将SqlCommandBuilder自身注册为事件的侦听器RowUpdating。 一次只能将一个 SqlDataAdapter 或 SqlCommandBuilder 对象相互关联。

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

SelectCommand 还必须至少返回一个主键或唯一列。 如果不存在，则会生成 InvalidOperation 异常，并且不会生成命令。

还SqlCommandBuilder使用 Connection引用的 SelectCommand、 CommandTimeout和 Transaction 属性。 如果修改了其中一个或多个属性，或者SelectCommand替换了自身，则用户应调用 RefreshSchema 。 否则， InsertCommandUpdateCommand和 DeleteCommand 属性将保留其以前的值。

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

构造函数

属性

方法

事件

适用于

另请参阅

• 在 ADO.NET 中检索和修改数据
• SQL Server 和 ADO.NET
• ADO.NET 概述