Compartilhar via


Como: implementar a atualização hierárquica em projetos existentes de Visual Studio

A partir de Visual Studio de 2008, datasets tipados são aprimorados pela TableAdapterManager componente.TableAdapterManagerreduz o código que é necessário para salvar os dados em várias tabelas relacionadas de diversas rotinas com muitas linhas de código para uma chamada de método único: 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 de Visual Studio de 2008) não contêm um TableAdapterManager componente.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 do TableAdapterManager.

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

ObservaçãoObservação

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 Configurações de Visual Studio.

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

  1. Abra o projeto que contém um dataset tipado ou conjuntos de dados em Visual Studio.

  2. Conclua o Visual Studio Conversion Wizard.

  3. Abra o dataset na Criando e editando conjuntos de dados tipados por 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. Sobre o Build menu, clique em Build Solution.

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

Novidades para desenvolvimento de aplicativos de dados no Visual Studio 2012

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

Visão geral do TableAdapterManager