IDataAdapter.Update(DataSet) Método

public:
 int Update(System::Data::DataSet ^ dataSet);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("IDataReader's (built from adapter commands) schema table types cannot be statically analyzed.")]
public int Update(System.Data.DataSet dataSet);

public int Update(System.Data.DataSet dataSet);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("IDataReader's (built from adapter commands) schema table types cannot be statically analyzed.")>]
abstract member Update : System.Data.DataSet -> int

abstract member Update : System.Data.DataSet -> int

Public Function Update (dataSet As DataSet) As Integer

Parâmetros

Retornos

O número de linhas atualizadas com êxito do DataSet.

Atributos

RequiresUnreferencedCodeAttribute

Exceções

Exemplos

O exemplo a seguir usa a classe derivada, OleDbDataAdapterpara Update a fonte de dados. Este exemplo pressupõe que você criou um OleDbDataAdapter e um DataSet.

static private DataSet CreateCommandAndUpdate(
    string connectionString,
    string queryString)
{
    DataSet dataSet = new DataSet();

    using (OleDbConnection connection =
               new OleDbConnection(connectionString))
    {
        connection.Open();
        OleDbDataAdapter adapter =
            new OleDbDataAdapter();
        adapter.SelectCommand =
            new OleDbCommand(queryString, connection);
        OleDbCommandBuilder builder =
            new OleDbCommandBuilder(adapter);

        adapter.Fill(dataSet);

        // Code to modify data in the DataSet here.

        // Without the OleDbCommandBuilder, this line would fail.
        adapter.UpdateCommand = builder.GetUpdateCommand();
        adapter.Update(dataSet);
    }
    return dataSet;
}

Public Function CreateCommandAndUpdate( _
    ByVal connectionString As String, _
    ByVal queryString As String) As DataSet

    Dim dataSet As New DataSet()

    Using connection As New OleDbConnection(connectionString)
        connection.Open()
        Dim adapter As New OleDbDataAdapter()

        adapter.SelectCommand = New OleDbCommand( _
            queryString, connection)

        Dim builder As OleDbCommandBuilder = _
            New OleDbCommandBuilder(adapter)

        adapter.Fill(dataSet)

        ' Code to modify the data in the DataSet here. 

        ' Without the OleDbCommandBuilder this line would fail.
        builder.GetUpdateCommand()
        adapter.Update(dataSet)
    End Using
    Return dataSet
End Function

Comentários

Quando um aplicativo chama o método Update, o IDataAdapter examina a propriedade RowState e executa as instruções INSERT, UPDATE ou DELETE necessárias iterativamente para cada linha, com base na ordem dos índices configurados no DataSet. Por exemplo, Update pode executar uma instrução DELETE, seguida por uma instrução INSERT e, em seguida, outra instrução DELETE, devido à ordenação das linhas no DataTable.

Lembre-se de que essas instruções não são executadas como um processo em lote; cada linha é atualizada individualmente. Um aplicativo pode chamar o GetChanges método se você precisar controlar a sequência de tipos de instrução (por exemplo, INSERTs antes de UPDATEs). Para obter mais informações, consulte Atualizando fontes de dados com DataAdapters.

Se as instruções INSERT, UPDATE ou DELETE não tiverem sido especificadas, o método Update gerará uma exceção. No entanto, você pode criar um objeto ou SqlCommandBuilder um OleDbCommandBuilder objeto para gerar automaticamente instruções SQL para atualizações de tabela única se definir a SelectCommand propriedade de um provedor de dados do .NET Framework. Em seguida, quaisquer instruções SQL adicionais que você não definir são geradas pelo CommandBuilder. Essa lógica de geração requer que as informações da coluna de chave estejam presentes no DataSet. Para obter mais informações, consulte Gerando comandos com CommandBuilders.

O método Update recupera linhas da tabela listada no primeiro mapeamento antes de executar uma atualização. Em Update seguida, atualiza a linha usando o valor da UpdatedRowSource propriedade. Todas as linhas adicionais retornadas são ignoradas.

Depois que os dados são carregados novamente no DataSet, o evento OnRowUpdated é gerado, permitindo que o usuário inspecione a linha DataSet reconciliada e quaisquer parâmetros de saída retornados pelo comando. Depois que uma linha é atualizada com êxito, as alterações nessa linha são aceitas.

Ao usar Update, a ordem de execução é a seguinte:

1. Os valores no DataRow são movidos para os valores de parâmetro.

2. O evento OnRowUpdating foi acionado.

3. O comando é executado.

4. Se o comando estiver definido como FirstReturnedRecord, o primeiro resultado retornado será colocado no DataRow.

5. Se houver parâmetros de saída, eles serão colocados no DataRow.

6. O evento OnRowUpdated foi acionado.

7. AcceptChanges é invocado.

Cada comando associado ao IDataAdapter geralmente tem uma coleção de parâmetros associada a ele. Os parâmetros são mapeados para a linha atual por meio das propriedades e SourceColumn da SourceVersion classe de um provedor de dados do Parameter .NET Framework. SourceColumn refere-se a uma coluna DataTable que o IDataAdapter faz referência para obter valores de parâmetro para a linha atual.

SourceColumn refere-se ao nome da coluna não mapeada antes de qualquer mapeamento de tabela ter sido aplicado. Se SourceColumn se referir a uma coluna inexistente, a ação executada dependerá de um dos seguintes valores de MissingMappingAction.

A propriedade SourceColumn também é usada para mapear o valor para parâmetros de saída ou entrada/saída de volta para o DataSet. Uma exceção será gerada se se referir a uma coluna inexistente.

A SourceVersion propriedade da classe de um provedor de dados do Parameter .NET Framework determina se o OriginalCurrentvalor da coluna deve ser usado ou Proposed a versão do valor da coluna. Essa funcionalidade é frequentemente usada para incluir valores originais na cláusula WHERE de uma instrução UPDATE para verificar se há violações de simultaneidade otimistas.