Compartilhar via


Como definir a ordem ao executar uma atualização hierárquica

Quando você salva dados modificados em um conjunto de dados para um banco de dados (com atualização hierárquica habilitada), é possível controlar a ordem que o TableAdapterManager usa para enviar Inserções, Atualizações e Exclusões individuais necessárias para salvar os dados. A ordem padrão para executar uma atualização hierárquica é Inserções, Atualizações, em seguida, Exclusões. O TableAdapterManager fornece uma propriedade UpdateOrder que pode ser definida para executar primeiro as Atualizações, depois as Inserções e as Exclusões.

É importante compreender que, por padrão, o TableAdapterManager primeiro executa as Inserções em todas as tabelas no conjunto de dados, depois as Atualizações em todas as tabelas no conjunto de dados, em seguida, as Exclusões em todas as tabelas no conjunto de dados.

Alterar a ordem de atualização para executar as Atualizações primeiro pode ser útil quando você está alterando os valores de chave primária de registros existentes. Executar a Atualização primeiro, modificará o registro existente como esperado. Executar a Inserção primeiro, criará um novo registro porque a nova chave primária ainda não está no banco de dados.

Procedimento

Para definir a ordem em que será executada uma atualização hierárquica

  1. Na exibição de Design, abra o formulário que contém o TableAdapterManager, que está executando a atualização.

  2. Clique em TableAdapterManager na bandeja de componentes.

  3. Defina a propriedade UpdateOrder na janela de Properties para a ordem necessária ao seu aplicativo.

Para definir via programação a ordem de execução de uma atualização hierárquica

  • O código a seguir define o TableAdapterManager para executar todas as Atualizações, depois todas as Inserções, em seguida, todas as Exclusões. (Substitua yourDataSetTableAdapters por um nome válido de seu projeto.)

    Me.TableAdapterManager.UpdateOrder = _
    yourDataSetTableAdapters.TableAdapterManager.UpdateOrderOption.UpdateInsertDelete
    
    this.tableAdapterManager.UpdateOrder = 
    yourDataSetTableAdapters.TableAdapterManager.UpdateOrderOption.UpdateInsertDelete;
    
  • O código a seguir define o TableAdapterManager para executar todas as Inserções, depois todas as Atualizações, em seguida, todas as Exclusões. É o comportamento padrão de TableAdapterManager.

    Me.TableAdapterManager.UpdateOrder = _
    yourDataSetTableAdapters.TableAdapterManager.UpdateOrderOption.InsertUpdateDelete
    
    this.tableAdapterManager.UpdateOrder = 
    yourDataSetTableAdapters.TableAdapterManager.UpdateOrderOption.InsertUpdateDelete;
    

Consulte também

Tarefas

Como habilitar e desabilitar atualização hierárquica

Instruções passo a passo: salvando dados de tabelas de dados relacionados (atualização hierárquica)

Conceitos

Visão geral de atualização hierárquica

Salvando dados em conjuntos de dados