Atualização hierárquica

Publicado: abril de 2016

Atualização hierárquica refere-se ao processo de salvar dados atualizados (de um dataset com duas ou mais tabelas relacionadas) para um banco de dados mantendo regras de integridade referencial.a integridade referencial refere-se às regras de consistência fornecido 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 aplica a criação de um registro de cliente antes de permitir pedidos a ser criado para esse cliente. Para obter mais informações sobre relacionamentos em conjuntos de dados, consulte Relacionamentos em conjuntos de dados

O recurso de atualização hierárquica usa um TableAdapterManager para gerenciar o TableAdapters em um dataset tipado. O TableAdapterManager componente é um Visual Studio— gerado de classe, portanto, não é parte do .NET Framework. Quando você arrasta uma tabela da janela fontes de dados a uma página de formulário do Windows Forms ou WPF, o Visual Studio adiciona uma variável do tipo TableAdapterManager à classe de formulário ou página e vê-lo no designer na bandeja de componentes. Para obter informações detalhadas sobre o TableAdapterManager de classe, consulte a seção TableAdapterManager Reference do Visão geral de TableAdapterManager.

Por padrão, um conjunto de dados trata tabelas relacionadas como "apenas 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 designer de conjunto de dados. Clique na linha de relação entre duas tabelas para abrir a caixa de diálogo relação. As alterações feitas aqui determinam como o TableAdapterManager se comporta quando ele envia as alterações nas tabelas relacionadas no banco de dados.

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

Por padrão, a atualização hierárquica está habilitada para todos os novos conjuntos de dados que são adicionados ou criados em um projeto. Ativar ou desativar o atualização hierárquica definindo a Hierarchical Update propriedade de um dataset tipado no Criando e editando conjuntos de dados tipados para True ou False:

Criar uma nova relação entre tabelas

Para criar uma nova relação entre duas tabelas no Dataset Designer, selecione a barra de título de cada tabela, em seguida, clique com botão direito e escolha Adicionar relação.

Restrições de chave estrangeira e atualizações em cascata e exclusões

É importante compreender como restrições de chave externa e comportamento em cascata no banco de dados são criados no código de dataset gerado.

Por padrão, as tabelas de dados em um conjunto de dados são geradas com relacionamentos (DataRelation) que coincidem com os relacionamentos no banco de dados. No entanto, o relacionamento no dataset não é gerado como uma restrição de chave estrangeira. O DataRelation é configurado como relação somente sem um UpdateRule ou DeleteRule em vigor.

Por padrão, atualizações em cascata e exclusões em cascata estão desativadas mesmo se a relação do banco de dados é definida com atualizações em cascata e/ou exclusões em cascata ativadas. Por exemplo, criar um novo cliente e um novo pedido e, em seguida, tentar salvar os dados podem causar um conflito com as restrições de chave estrangeira definidas no banco de dados. Para obter mais informações, consulte Como configurar restrições de chave estrangeira em um conjunto de dados.

Definindo a ordem para executar atualizações

Definindo a ordem para executar atualizações define a ordem da pessoa inserções, atualizações e exclusões necessárias para salvar todos os dados modificados em todas as tabelas de um dataset. Quando a atualização hierárquica está habilitada, inserções são executadas em primeiro lugar, em seguida, atualiza e exclui. O TableAdapterManager fornece um UpdateOrder propriedade que pode ser definida para executar atualizações em primeiro lugar, em seguida, inserções e exclusões.

Para definir o UpdateOrder propriedade após arrastar itens do Janela Fontes de Dados para um formulário, clique no TableAdapterManager na bandeja de componentes e definir o UpdateOrder propriedade o propriedades janela. Para obter mais informações, consulte Como definir a ordem ao executar uma atualização hierárquica.

Criando 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 para qualquer tabela falhar, a transação inteira é revertida. Na maioria das situações, a reversão da transação retorna seu aplicativo para seu estado original. No entanto, talvez você deseje restaurar o conjunto de dados da cópia de backup. Um exemplo é quando você está usando valores de incremento automático. Por exemplo, se salvar operação não for bem-sucedida, os valores de incremento automático não são redefinidos no conjunto de dados e o dataset continuará a criar valores de incremento automático, deixando um intervalo na numeração que pode não ser aceitável em seu aplicativo. Em situações em que isso é um problema, o TableAdapterManager fornece um BackupDataSetBeforeUpdate propriedade que substitui o conjunto de dados existente por uma cópia de backup se a transação falhar.

Modificando o código salvar gerado para executar a atualização hierárquica

Salve as alterações das tabelas relacionadas de dados no conjunto de dados no 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 no NorthwindDataset para o banco de dados de back-end.

Depois de soltar os itens do fontes de dados janela, código é adicionado automaticamente para o Form_Load evento para preencher cada tabela (o TableAdapter.Fill métodos). Código também é adicionado ao Salvar evento de clique de botão a BindingNavigator para salvar dados do conjunto de dados no banco de dados (o TableAdapterManager.UpdateAll método).

O código salvar gerado também contém uma linha de código que chama o CustomersBindingSource.EndEdit método. Mais especificamente, ele chama o EndEdit método do primeiro BindingSource adicionado ao formulário. Em outras palavras, esse código é gerado apenas para a primeira tabela arrastada do fontes de dados window para o formulário. O EndEdit chamada confirma as alterações que estão em processo em quaisquer controles ligados a dados que estão sendo editados atualmente. Portanto, se um controle ligado a dados ainda tem foco e você clicar o Salvar botão, todas as edições pendentes nesse controle serão confirmadas antes de salvar (o TableAdapterManager.UpdateAll método).

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

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

2. Adicionar 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 de Salvar clique no botão eventos devem se parecer com o seguinte:

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

           Me.Validate()
           Me.CustomersBindingSource.EndEdit()
           Me.OrdersBindingSource.EndEdit()
           Me.TableAdapterManager.UpdateAll(Me.NorthwindDataSet)
   

Além de confirmar as alterações em uma tabela filho relacionada antes de salvar dados em um banco de dados, você também terá que registros pai de confirmação recém-criados antes de adicionar novos registros filho a um conjunto de dados. Em outras palavras, você talvez precise adicionar o novo registro pai (cliente) para o conjunto de dados antes das restrições de chave estrangeiras habilitar novos registros filho (pedidos) sejam adicionados ao conjunto de dados. Para fazer isso, você pode usar o filho BindingSource.AddingNew eventos.

Para adicionar código para confirmar registros pai no conjunto de dados antes de adicionar novos registros filho

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

   • Abra Form1 no modo design, clique em OrdersBindingSource na bandeja de componentes, selecione eventos no propriedades janela e clique duas vezes o AddingNew eventos.

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

               this.customersBindingSource.EndEdit();
   

           Me.CustomersBindingSource.EndEdit()
   

Referência de TableAdapterManager

Por padrão, um TableAdapterManager classe é gerada quando você cria um conjunto de dados que contém tabelas relacionadas. Para impedir que a classe que está sendo gerado, altere o valor de Hierarchical Update propriedade do conjunto de dados como false. Quando você arrasta uma tabela que tenha uma relação na superfície de design de um Windows Form ou página WPF, o Visual Studio declara uma variável de membro da classe. Se você não usar a ligação de dados, você precisa declarar manualmente a variável.

O TableAdapterManager classe não é parte do .NET Framework. Portanto, você não pode procurar por ele na documentação. Ele é criado em tempo de design como parte do processo de criação de conjunto de dados.

A seguir estão os métodos usados frequentemente e propriedades do TableAdapterManager classe:

Consulte também

Salvar dados no banco de dados