SqlCommandBuilder Classe

Definição

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

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

public sealed class SqlCommandBuilder : System.ComponentModel.Component

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

type SqlCommandBuilder = class
    inherit Component

type SqlCommandBuilder = class
    inherit DbCommandBuilder

Public NotInheritable Class SqlCommandBuilder
Inherits Component

Public NotInheritable Class SqlCommandBuilder
Inherits DbCommandBuilder

Herança

Object

MarshalByRefObject

Component

SqlCommandBuilder

Herança

Object

MarshalByRefObject

Component

DbCommandBuilder

SqlCommandBuilder

Exemplos

O exemplo seguinte usa os SqlCommand, along SqlDataAdapter e SqlConnection, para selecionar linhas de uma fonte de dados. O exemplo recebe uma cadeia de ligação, uma cadeia de consulta que é uma instrução Transact-SQL SELECT e uma cadeia que é o nome da tabela da base de dados. O exemplo cria então um 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

Observações

O SqlDataAdapter não gera automaticamente as instruções Transact-SQL necessárias para conciliar alterações feitas a um DataSet com a instância associada de SQL Server. No entanto, pode criar um objeto SqlCommandBuilder para gerar automaticamente instruções Transact-SQL para atualizações de tabela única se definir a propriedade SelectCommand do SqlDataAdapter. Depois, quaisquer instruções Transact-SQL adicionais que não definas são geradas pelo SqlCommandBuilder.

Regista-se SqlCommandBuilder como ouvinte de RowUpdating eventos sempre que defines a DataAdapter propriedade. Só pode associar um SqlDataAdapter ou SqlCommandBuilder objeto ao outro de cada vez.

Para gerar instruções INSERT, UPDATE ou DELETE, utiliza SqlCommandBuilder a SelectCommand propriedade para recuperar automaticamente um conjunto necessário de metadados. Se alterar o SelectCommand método depois de os metadados terem sido recuperados, como após a primeira atualização, deve chamar o RefreshSchema método para atualizar os metadados.

O SelectCommand também deve retornar pelo menos uma chave primária ou coluna exclusiva. Se não houver nenhuma exceção, é gerada uma exceção InvalidOperation , e os comandos não são gerados.

O SqlCommandBuilder também usa os Connection, CommandTimeout, e Transaction propriedades referenciadas pelos SelectCommand. O utilizador deve ligar RefreshSchema se uma ou mais destas propriedades forem modificadas, ou se a SelectCommand própria propriedade for substituída. Caso contrário, as InsertCommandpropriedades , UpdateCommand, e DeleteCommand mantêm os seus valores anteriores.

Se chamar Dispose, o SqlCommandBuilder é dissociado do SqlDataAdapter, e os comandos gerados deixam de ser usados.

Ver também

• Recuperando e modificando dados no ADO.NET
• SQL Server e ADO.NET
• Visão geral ADO.NET