Atualização hierárquica no desenvolvimento do .NET Framework

Atualização hierárquica refere-se ao processo de salvar dados atualizados (de um conjunto de dados com duas ou mais tabelas relacionadas) de volta a um banco de dados, mantendo regras de integridade referencial. Integridade referencial refere-se às regras de consistência fornecidas pelas restrições em um banco de dados que controlam o comportamento de inserir, atualizar e excluir registros relacionados. Por exemplo, é a integridade referencial que impõe a criação de um registro de cliente antes de permitir que pedidos sejam criados para esse cliente. Para obter mais informações sobre relações em conjuntos de dados, consulte Relações em conjuntos de dados.

O recurso de atualização hierárquica usa a TableAdapterManager para gerenciar os TableAdapters em um conjunto de dados tipado. O TableAdapterManager componente é uma classe gerada pelo Visual Studio, não um tipo .NET. Quando você arrasta uma tabela da janela Fontes de dados para uma página do Windows Form ou WPF, o Visual Studio adiciona uma variável do tipo TableAdapterManager ao formulário ou página e você a vê no designer na bandeja do componente. Para obter informações detalhadas sobre a TableAdapterManager classe, consulte a seção Referência TableAdapterManager de TableAdapters.

Por padrão, um conjunto de dados trata tabelas relacionadas como "somente relações", o que significa que ele não impõe restrições de chave estrangeira. Você pode modificar essa configuração em tempo de design usando o Dataset Designer. Selecione a linha de relação entre duas tabelas para abrir a caixa de diálogo Relação . As alterações feitas aqui determinarão como o TableAdapterManager se comporta quando ele envia as alterações nas tabelas relacionadas de volta para o banco de dados.

Habilitar atualização hierárquica em um conjunto de dados

Por padrão, a atualização hierárquica é habilitada para todos os novos conjuntos de dados adicionados ou criados em um projeto. Ative ou desative a atualização hierárquica definindo a propriedade Atualização Hierárquica de um conjunto de dados tipado em O conjunto de dados como Verdadeiro ou Falso:

Criar uma nova relação entre tabelas

Para criar uma nova relação entre duas tabelas, no Designer de Conjunto de Dados, selecione a barra de título de cada tabela, clique com o botão direito do mouse e selecione Adicionar relação.

Compreender restrições de chave estrangeira, atualizações em cascata e exclusões

É importante entender como as restrições de chave estrangeira e o comportamento em cascata no banco de dados são criados no código do conjunto de dados gerado.

Por padrão, as tabelas de dados em um conjunto de dados são geradas com relações (DataRelation) que correspondem às relações no banco de dados. No entanto, a relação no conjunto de dados não é gerada como uma restrição de chave estrangeira. O DataRelation é configurado como Somente relação sem UpdateRule ou DeleteRule em vigor.

Por padrão, as atualizações em cascata e as exclusões em cascata são desativadas mesmo se a relação de banco de dados estiver definida com atualizações em cascata ou exclusões em cascata ativadas. Por exemplo, criar um novo cliente e um novo pedido e, em seguida, tentar salvar os dados pode causar um conflito com as restrições de chave estrangeira definidas no banco de dados. Para obter mais informações, consulte Desativar restrições ao preencher um conjunto de dados.

Definir a ordem para executar atualizações

Definir a ordem para executar atualizações define a ordem das inserções, atualizações e exclusões individuais necessárias para salvar todos os dados modificados em todas as tabelas de um conjunto de dados. Quando a atualização hierárquica está habilitada, as inserções são executadas primeiro, depois as atualizações e, em seguida, as exclusões. O TableAdapterManager fornece uma propriedade UpdateOrder que pode ser definida para executar primeiro as atualizações, depois as inserções, e por fim as eliminações.

Para definir a UpdateOrder propriedade, depois de arrastar itens da janela Fontes de Dados para um formulário, selecione a TableAdapterManager na bandeja do componente e defina a UpdateOrder propriedade na janela Propriedades .

Criar uma cópia de backup de um conjunto de dados antes de executar uma atualização hierárquica

Quando você salva dados (chamando o TableAdapterManager.UpdateAll() método), o TableAdapterManager tenta atualizar os dados para cada tabela em uma única transação. Se qualquer parte da atualização de qualquer tabela falhar, toda a transação será revertida. Na maioria das situações, a reversão retorna seu aplicativo ao seu estado original.

No entanto, às vezes você pode querer restaurar o conjunto de dados a partir da cópia de backup. Um exemplo disso pode ocorrer quando você estiver usando valores de incremento automático. Por exemplo, se uma operação de salvamento não for bem-sucedida, os valores de incremento automático não serão redefinidos no conjunto de dados e o conjunto de dados continuará a criar valores de incremento automático. Isso deixa uma lacuna na numeração que pode não ser aceitável em seu aplicativo. Em situações em que isso é um problema, o TableAdapterManager fornece uma BackupDataSetBeforeUpdate propriedade que substitui o conjunto de dados existente por uma cópia de backup se a transação falhar.

Modificar o código de salvamento gerado para executar a atualização hierárquica

Salve as alterações das tabelas de dados relacionadas no conjunto de dados para o banco de dados chamando o TableAdapterManager.UpdateAll método e passando o nome do conjunto de dados que contém as tabelas relacionadas. Por exemplo, execute o TableAdapterManager.UpdateAll(NorthwindDataset) método para enviar atualizações de todas as tabelas em NorthwindDataset para o banco de dados back-end.

Depois de soltar os itens da janela Fontes de dados, o código é automaticamente adicionado ao evento Form_Load para preencher cada tabela com os métodos TableAdapter.Fill. O código também é adicionado ao evento de clique do botão Salvar para BindingNavigator salvar dados do conjunto de dados de volta ao banco de dados (através do método TableAdapterManager.UpdateAll).

O código de salvamento gerado também contém uma linha de código que chama o CustomersBindingSource.EndEdit método. Mais especificamente, ele chama o método EndEdit do primeiro BindingSource que é adicionado ao formulário. Em outras palavras, esse código é gerado apenas para a primeira tabela que é arrastada da janela Fontes de Dados para o formulário. A EndEdit chamada confirma todas as alterações que estão em processo em quaisquer controles ligados a dados que estão sendo editados no momento. Portanto, se um controlo vinculado a dados ainda tiver foco e clicar no botão Salvar, todas as edições pendentes nesse controlo serão confirmadas antes do salvamento real (o método TableAdapterManager.UpdateAll).

Para atualizar o código para confirmar alterações nas tabelas relacionadas antes de salvar

1. Clique duas vezes no botão Salvar para BindingNavigator abrir o Form1 no Editor de códigos .

2. Adicione uma linha de código para chamar o OrdersBindingSource.EndEdit método após a linha que chama o CustomersBindingSource.EndEdit método. O código no evento clique no botão Salvar deve ser semelhante ao seguinte:

   • C#
   • VB

   this.Validate();
   this.customersBindingSource.EndEdit();
   this.ordersBindingSource.EndEdit();
   this.tableAdapterManager.UpdateAll(this.northwindDataSet);
   

Além de confirmar alterações em uma tabela filho relacionada antes de salvar dados em um banco de dados, talvez seja necessário confirmar registros pai recém-criados antes de adicionar novos registros filho a um conjunto de dados. Em outras palavras, talvez seja necessário adicionar o novo registro pai (Customer) ao conjunto de dados antes que restrições de chave estrangeira permitam que novos registros filho (Orders) sejam adicionados ao conjunto de dados. Para fazer isso, você pode usar o evento filho BindingSource.AddingNew .

Para adicionar código para confirmar registos principais no conjunto de dados antes de adicionar novos registos secundários.

1. Crie um manipulador de eventos para o evento OrdersBindingSource.AddingNew.

   • Abra o Form1 no modo de design, selecione OrdersBindingSource na bandeja do componente, selecione Eventos na janela Propriedades e clique duas vezes no evento AddingNew .

2. Adicione uma linha de código ao manipulador de eventos que chama o CustomersBindingSource.EndEdit método. O código no manipulador de OrdersBindingSource_AddingNew eventos deve ser semelhante ao seguinte:

   • C#
   • VB

   this.customersBindingSource.EndEdit();
   

Referência do TableAdapterManager

Por padrão, uma TableAdapterManager classe é gerada quando você cria um conjunto de dados que contém tabelas relacionadas. Para evitar que a classe seja gerada, altere o Hierarchical Update valor da propriedade do conjunto de dados para false. Quando arrastas uma tabela que tem uma relação para a superfície de design de uma página do Windows Form ou WPF, o Visual Studio declara uma variável membro da classe. Se você não usar databinding, terá que declarar manualmente a variável.

A TableAdapterManager classe não é um tipo .NET. Portanto, você não pode procurá-lo na documentação. Ele é criado durante a fase de design como parte do processo de criação do conjunto de dados.

A seguir estão os métodos e propriedades usados com freqüência da TableAdapterManager classe:

Conteúdo relacionado

• Salvar dados de volta no banco de dados