Manipular uma exceção de simultaneidade em aplicativos de banco de dados do .NET Framework

As exceções de simultaneidade (System.Data.DBConcurrencyException) são geradas quando dois usuários tentam alterar os mesmos dados em um banco de dados ao mesmo tempo. Neste passo a passo, você cria um aplicativo do Windows que ilustra como capturar um DBConcurrencyException, localizar a linha que causou o erro e aprender uma estratégia de como lidar com ele.

Este passo a passo leva você pelo seguinte processo:

1. Crie um novo projeto do Aplicativo Windows Forms (.NET Framework ).

2. Crie um novo conjunto de dados com base na tabela Northwind Customers.

3. Crie um formulário com um DataGridView para exibir os dados.

4. Preencha um conjunto de dados com dados da tabela Clientes no banco de dados Northwind.

5. Use o recurso Mostrar Dados da Tabela no Gerenciador de Servidores para acessar os dados da tabela Clientes e alterar um registro.

6. Altere o mesmo registro para um valor diferente, atualize o conjunto de dados e tente gravar as alterações no banco de dados, o que resulta em um erro de simultaneidade sendo gerado.

7. Pegue o erro e exiba as diferentes versões do registro, permitindo que o usuário determine se deseja continuar e atualizar o banco de dados ou cancelar a atualização.

Pré-requisitos

Este passo a passo usa o SQL Server Express LocalDB e o banco de dados de exemplo Northwind.

1. Se você não tiver o SQL Server Express LocalDB, instale-o na página de download do SQL Server Express ou por meio do Instalador do Visual Studio. No Instalador do Visual Studio, você pode instalar o SQL Server Express LocalDB como parte da carga de trabalho Armazenamento e processamento de dados ou como um componente individual.

2. Instale o banco de dados de exemplo Northwind seguindo estas etapas:

   1. No Visual Studio, abra a janela Pesquisador de Objetos do SQL Server. (O Pesquisador de Objetos do SQL Server é instalado como parte da carga de trabalho de armazenamento e processamento de dados no Instalador do Visual Studio.) Expanda o nó do SQL Server . Clique com o botão direito do mouse na instância do LocalDB e selecione Nova Consulta.

      Uma janela do editor de consultas é aberta.

   2. Copie o script Transact-SQL da Northwind para sua área de transferência. Esse script T-SQL cria o banco de dados Northwind do zero e o preenche com dados.

   3. Cole o script T-SQL no editor de consultas e, em seguida, escolha o botão Executar.

      Após um curto período de tempo, a consulta termina de ser executada e o banco de dados Northwind é criado.

Criar um novo projeto

Comece criando um novo aplicativo do Windows Forms:

1. No Visual Studio, no menu Arquivo, selecione Novo>Projeto.

2. Expanda o Visual C# ou o Visual Basic no painel esquerdo e selecione a Área de Trabalho do Windows.

3. No painel do meio, selecione o tipo de projeto de Aplicativo do Windows Forms .

4. Nomeie o projeto ConcurrencyWalkthrough e escolha OK.

   O projeto ConcurrencyWalkthrough é criado e adicionado ao Gerenciador de Soluções e um novo formulário é aberto no designer.

Criar o conjunto de dados Northwind

Em seguida, crie um conjunto de dados chamado NorthwindDataSet:

1. No menu Dados , escolha Adicionar Nova Fonte de Dados.

   O Assistente de Configuração de Fonte de Dados é aberto.

2. Na tela Escolher um Tipo de Fonte de Dados , selecione Banco de Dados.

   

3. Selecione uma conexão com o banco de dados de exemplo Northwind na lista de conexões disponíveis. Se a conexão não estiver disponível na lista de conexões, selecione Nova Conexão.

   Observação

   Se você estiver se conectando a um arquivo de banco de dados local, selecione Não quando perguntado se deseja adicionar o arquivo ao seu projeto.

4. Na tela Salvar cadeia de conexão no arquivo de configuração do aplicativo, selecione Avançar.

5. Expanda o nó Tabelas e selecione a tabela Clientes . O nome padrão do conjunto de dados deve ser NorthwindDataSet.

6. Selecione Concluir para adicionar o conjunto de dados ao projeto.

Criar um controle DataGridView associado a dados

Nesta seção, você criará um System.Windows.Forms.DataGridView arrastando o item Clientes da janela Fontes de Dados para seu Formulário do Windows.

1. Para abrir a janela Fontes de Dados , no menu Dados , escolha Mostrar Fontes de Dados.

2. Na janela Fontes de Dados, expanda o nó NorthwindDataSet e selecione a tabela Clientes.

3. Selecione a seta para baixo no nó da tabela e, em seguida, selecione DataGridView na lista suspensa.

4. Arraste a tabela para uma área vazia do formulário.

   Um DataGridView controle chamado CustomersDataGridView, e um BindingNavigator chamado CustomersBindingNavigator, são adicionados ao formulário que está vinculado ao BindingSource. Este, por sua vez, está associado à tabela Clientes no NorthwindDataSet.

Testar o formulário

Agora você pode testar o formulário para garantir que ele se comporte conforme o esperado até este ponto:

1. Selecione F5 para executar o aplicativo.

   O formulário é exibido com um controle DataGridView que é preenchido com os dados da tabela Clientes.

2. No menu Depurar, selecione Interromper Depuração.

Tratar erros de simultaneidade

A maneira como você lida com erros depende das regras de negócios específicas que regem seu aplicativo. Para este passo a passo, usamos a estratégia a seguir como um exemplo de como lidar com o erro de simultaneidade.

O aplicativo apresenta ao usuário três versões do registro:

• O registro atual no banco de dados

• O registro original carregado no conjunto de dados

• As alterações propostas no conjunto de dados

Em seguida, o usuário pode substituir o banco de dados com a versão proposta ou cancelar a atualização e atualizar o conjunto de dados com os novos valores do banco de dados.

Para habilitar o tratamento de erros de concorrência

1. Crie um manipulador de erros personalizado.

2. Exibir opções para o usuário.

3. Processe a resposta do usuário.

4. Reenviar a atualização ou redefinir os dados no conjunto de dados.

Adicionar código para lidar com a exceção de simultaneidade

Quando você tenta executar uma atualização e uma exceção é gerada, você geralmente deseja fazer algo com as informações fornecidas pela exceção gerada. Nesta seção, você adicionará o código que tenta atualizar o banco de dados. Você também vai tratar qualquer DBConcurrencyException que possa ser gerada, bem como quaisquer outras exceções.

1. Adicione o seguinte código abaixo do Form1_Load método:

   • C#
   • VB

   private void UpdateDatabase()
   {
       try
       {
           this.customersTableAdapter.Update(this.northwindDataSet.Customers);
           MessageBox.Show("Update successful");
       }
       catch (DBConcurrencyException dbcx)
       {
           DialogResult response = MessageBox.Show(CreateMessage((NorthwindDataSet.CustomersRow)
               (dbcx.Row)), "Concurrency Exception", MessageBoxButtons.YesNo);
   
           ProcessDialogResult(response);
       }
       catch (Exception ex)
       {
           MessageBox.Show("An error was thrown while attempting to update the database.");
       }
   }
   

2. Substitua o CustomersBindingNavigatorSaveItem_Click método para chamar o UpdateDatabase método para que ele se pareça com o seguinte:

   • C#
   • VB

   private void customersBindingNavigatorSaveItem_Click(object sender, EventArgs e)
   {
       UpdateDatabase();
   }
   

Exibir opções para o usuário

O código que você acabou de escrever chama o CreateMessage procedimento para exibir informações de erro para o usuário. Para este passo a passo, use uma caixa de mensagem para exibir as diferentes versões do registro para o usuário. Isso permite que o usuário escolha se deseja substituir o registro com as alterações ou cancelar a edição. Depois que o usuário seleciona uma opção (clica em um botão) na caixa de mensagem, a resposta é passada para o ProcessDialogResult método.

Crie a mensagem adicionando o código a seguir ao Editor de Código. Insira este código abaixo do UpdateDatabase método:

private string CreateMessage(NorthwindDataSet.CustomersRow cr)
{
    return
        "Database: " + GetRowData(GetCurrentRowInDB(cr), DataRowVersion.Default) + "\n" +
        "Original: " + GetRowData(cr, DataRowVersion.Original) + "\n" +
        "Proposed: " + GetRowData(cr, DataRowVersion.Current) + "\n" +
        "Do you still want to update the database with the proposed value?";
}


//--------------------------------------------------------------------------
// This method loads a temporary table with current records from the database
// and returns the current values from the row that caused the exception.
//--------------------------------------------------------------------------
private NorthwindDataSet.CustomersDataTable tempCustomersDataTable = 
    new NorthwindDataSet.CustomersDataTable();

private NorthwindDataSet.CustomersRow GetCurrentRowInDB(NorthwindDataSet.CustomersRow RowWithError)
{
    this.customersTableAdapter.Fill(tempCustomersDataTable);

    NorthwindDataSet.CustomersRow currentRowInDb = 
        tempCustomersDataTable.FindByCustomerID(RowWithError.CustomerID);

    return currentRowInDb;
}


//--------------------------------------------------------------------------
// This method takes a CustomersRow and RowVersion 
// and returns a string of column values to display to the user.
//--------------------------------------------------------------------------
private string GetRowData(NorthwindDataSet.CustomersRow custRow, DataRowVersion RowVersion)
{
    string rowData = "";

    for (int i = 0; i < custRow.ItemArray.Length ; i++ )
    {
        rowData = rowData + custRow[i, RowVersion].ToString() + " ";
    }
    return rowData;
}

Private Function CreateMessage(ByVal cr As NorthwindDataSet.CustomersRow) As String
    Return "Database: " & GetRowData(GetCurrentRowInDB(cr), 
                                     Data.DataRowVersion.Default) & vbCrLf &
           "Original: " & GetRowData(cr, Data.DataRowVersion.Original) & vbCrLf &
           "Proposed: " & GetRowData(cr, Data.DataRowVersion.Current) & vbCrLf &
           "Do you still want to update the database with the proposed value?"
End Function


'--------------------------------------------------------------------------
' This method loads a temporary table with current records from the database
' and returns the current values from the row that caused the exception.
'--------------------------------------------------------------------------
Private TempCustomersDataTable As New NorthwindDataSet.CustomersDataTable

Private Function GetCurrentRowInDB(
    ByVal RowWithError As NorthwindDataSet.CustomersRow
    ) As NorthwindDataSet.CustomersRow

    Me.CustomersTableAdapter.Fill(TempCustomersDataTable)

    Dim currentRowInDb As NorthwindDataSet.CustomersRow =
        TempCustomersDataTable.FindByCustomerID(RowWithError.CustomerID)

    Return currentRowInDb
End Function


'--------------------------------------------------------------------------
' This method takes a CustomersRow and RowVersion 
' and returns a string of column values to display to the user.
'--------------------------------------------------------------------------
Private Function GetRowData(ByVal custRow As NorthwindDataSet.CustomersRow,
    ByVal RowVersion As Data.DataRowVersion) As String

    Dim rowData As String = ""

    For i As Integer = 0 To custRow.ItemArray.Length - 1
        rowData &= custRow.Item(i, RowVersion).ToString() & " "
    Next

    Return rowData
End Function

Processar a resposta do usuário

Você também precisa de código para processar a resposta do usuário à caixa de mensagem. As opções são substituir o registro atual no banco de dados com a alteração proposta ou abandonar as alterações locais e atualizar a tabela de dados com o registro que está atualmente no banco de dados. Se o usuário escolher Sim, o Merge método será chamado com o argumento preserveChanges definido como true. Isso faz com que a tentativa de atualização seja bem-sucedida, pois a versão original do registro agora corresponde ao registro no banco de dados.

Adicione o seguinte código abaixo do código que foi adicionado na seção anterior:

// This method takes the DialogResult selected by the user and updates the database 
// with the new values or cancels the update and resets the Customers table 
// (in the dataset) with the values currently in the database.

private void ProcessDialogResult(DialogResult response)
{
    switch (response)
    {
        case DialogResult.Yes:
            northwindDataSet.Merge(tempCustomersDataTable, true, MissingSchemaAction.Ignore);
            UpdateDatabase();
            break;

        case DialogResult.No:
            northwindDataSet.Merge(tempCustomersDataTable);
            MessageBox.Show("Update cancelled");
            break;
    }
}

' This method takes the DialogResult selected by the user and updates the database 
' with the new values or cancels the update and resets the Customers table 
' (in the dataset) with the values currently in the database.

Private Sub ProcessDialogResult(ByVal response As Windows.Forms.DialogResult)

    Select Case response

        Case Windows.Forms.DialogResult.Yes
            NorthwindDataSet.Customers.Merge(TempCustomersDataTable, True)
            UpdateDatabase()

        Case Windows.Forms.DialogResult.No
            NorthwindDataSet.Customers.Merge(TempCustomersDataTable)
            MsgBox("Update cancelled")
    End Select
End Sub

Testar o comportamento do formulário

Agora você pode testar o formulário para garantir que ele se comporte conforme o esperado. Para simular uma violação de simultaneidade, altere os dados no banco de dados depois de preencher o NorthwindDataSet.

1. Selecione F5 para executar o aplicativo.

2. Depois que o formulário for exibido, deixe-o em execução e alterne para o IDE do Visual Studio.

3. No menu Exibir , escolha Gerenciador de Servidores.

4. No Gerenciador de Servidores, expanda a conexão que seu aplicativo está usando e expanda o nó Tabelas.

5. Clique com o botão direito do mouse na tabela Clientes e selecione Mostrar Dados da Tabela.

6. No primeiro registro (ALFKI), altere ContactName para Maria Anders2.

   Observação

   Navegue até uma linha diferente para confirmar a alteração.

7. Alterne para o formulário em execução do ConcurrencyWalkthrough.

8. No primeiro registro no formulário (ALFKI), altere ContactName para Maria Anders1.

9. Selecione o botão Salvar.

   O erro de simultaneidade é gerado e a caixa de mensagem é exibida.

   Selecionar Não cancela a atualização e atualiza o conjunto de dados com os valores que estão atualmente no banco de dados. Selecionar Sim grava o valor proposto no banco de dados.

Conteúdo relacionado

• Salvar dados de volta no banco de dados