Compartilhar via


Como implementar atualização hierárquica em projetos existentes no Visual Studio

Iniciando no Visual Studio 2008, datasets tipados são aprimorados pelo componente de TableAdapterManager . TableAdapterManager reduz o código necessário para salvar dados em várias tabelas relacionadas de várias rotinas com várias linhas de código para uma única chamada de método: TableAdapterManager.UpdateAll(TypedDataset). Por padrão, hierárquica atualização está ativada para todos os novos conjuntos de dados que são adicionados ou criados em um projeto. Conjuntos de dados existentes (conjuntos de dados criados em versões do Visual Studio antes do Visual Studio 2008) não contêm um componente de TableAdapterManager . Portanto, por padrão, conjuntos de dados criados em versões anteriores têm sua propriedade Hierarchical Update definida como False. Gerar componentes TableAdapterManager definindo a propriedade Hierarchical Update para True e salvando o conjunto de dados. Para obter mais informações, consulte Visão geral de TableAdapterManager.

Ativar atualização hierárquica e gerar o componente TableAdapterManager

Dica

Seu computador pode mostrar nomes ou locais diferentes para alguns dos elementos da interface do usuário do Visual Studio nas instruções a seguir. A edição do Visual Studio que você possui e as configurações que você usa determinam esses elementos. Para obter mais informações, consulte Personalizando configurações de desenvolvimento no Visual Studio.

Para ativar a atualização hierárquica em versões anteriores de datasets tipados

  1. Abra o projeto que contém um conjunto de dados ou datasets no Visual Studio.

  2. Conclua o Visual Studio Conversion Wizard.

  3. Abra o dataset em Criando e editando conjuntos de dados tipados clicando duas vezes no arquivo .xsd no Solution Explorer.

  4. Clique em uma área vazia no Dataset Designer.

  5. Localize a propriedade Hierarchical Update na Janela Propriedades.

  6. Defina o valor da propriedade Hierarchical Update como True.

  7. No menu Compilar, clique em Compilar Solução.

Configurando o TableAdapterManager e Salvando Dados

Definir a propriedade Hierarchical Update para True e salvar o conjunto de dados gera o componente TableAdapterManager que habilita a atualização hierárquica. Após você gerar o componente TableAdapterManager, atualize seu código existente para instanciar um novo TableAdapterManager e chame o método TableAdapterManager.UpdateAll() em vez de chamar os métodos TableAdapter.Update() individuais. Se o código TableAdapter existente estiver em um biblioteca de classes (ou qualquer arquivo que não tenha uma interface de usuário) você deve instanciar programaticamente um novo TableAdapterManager. Se o código TableAdapter existente estiver em um formulário, você pode instanciar um novo TableAdapterManager arrastando um componente TableAdapterManager do Toolbox para o formulário.

TableAdapterManagers são altamente tipados, o que significa que eles são gerados com propriedades que fazem referência aos TableAdapters individuais que eles gerenciam. Após você instanciar um TableAdapterManager, defina as propriedades TableAdapter individuais para as instâncias de cada TableAdapter, conforme mostrado nos procedimentos a seguir.

Para adicionar um TableAdapterManager a um projeto existente sem uma interface de usuário

  1. Localize o código que chama os métodos TableAdapter.Update (por exemplo, CustomersTableAdapter.Update(NorthwindDataSet.Customers)).

  2. Substitua o código que chama os métodos TableAdapter.Update individuais pelo seguinte:

    Dim adapterManager as new TableAdapterManager
    adapterManager.TableName1TableAdapter = new _
    TableName1TableAdapter
    adapterManager.TableName2TableAdapter = new _
    TableName2TableAdapter
    
    adapterManager.UpdateAll(Me.DataSetName)
    
    TableAdapterManager adapterManager = 
    new TableAdapterManager();
    
    adapterManager.TableName1TableAdapter = 
    new TableName1TableAdapter();
    adapterManager.TableName2TableAdapter = 
    new TableName2TableAdapter();
    
    adapterManager.UpdateAll(this.DataSetName);
    

Para adicionar um TableAdapterManager a um projeto existente que tem uma interface de usuário

  1. Abra o formulário no modo de design.

  2. Arraste um componente TableAdapterManager do ToolBox para o formulário.

  3. Localize o código que chama os métodos TableAdapter.Update (por exemplo, CustomersTableAdapter.Update(NorthwindDataSet.Customers)).

  4. Substitua o código que chama os métodos TableAdapter.Update individuais pelo seguinte:

    Me.TableAdapterManager.TableName1TableAdapter = _
    new DatasetNameTableAdapters.TableName1TableAdapter
    Me.TableAdapterManager.TableName2TableAdapter = _
    new DatasetNameTableAdapters.TableName2TableAdapter
    
    Me.TableAdapterManager.UpdateAll(Me.DataSetName)
    
    TableAdapterManager.TableName1TableAdapter = new 
    TableName1TableAdapter();
    TableAdapterManager.TableName2TableAdapter = new 
    TableName2TableAdapter();
    
    TableAdapterManager.UpdateAll(this.DataSetName);
    

Consulte também

Conceitos

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

Visão geral de TableAdapterManager