Compartilhar via


Como: Implementar a atualização hierárquica em projetos existentes do Visual Studio

In Visual Studio 2008, datasets digitados são avançado por um novo TableAdapterManager componente. TableAdapterManager reduz o código que é necessário para salvar dados em várias tabelas relacionadas de várias rotinas com várias linhas de código para uma telefonar de método único: TableAdapterManager.UpdateAll(TypedDataset). Por padrão, a atualização hierárquica está habilitada para todos os novos conjuntos de dados que são adicionados a ou criados em um projeto. Conjuntos de dados existentes (conjuntos de dados criados em versões anteriores do Visual Studio) não contêm um componente 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 do TableAdapterManager.

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

Observação:

Seu computador pode mostrar diferentes nomes ou localizações para alguns dos elementos de 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 do 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 datasets no Visual Studio 2008.

    The Assistente de conversão do Visual Studio opens.

  2. Conclua o Visual Studio Conversion Wizard.

  3. Abra o conjunto de dados no Dataset Designer clicando duas vezes no arquivo. xsd no Explorer solução.

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

  5. Localize a propriedade Hierarchical Update na Janela Properties.

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

  7. On the Compilação menu, clicar Criar 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

O que Há de Novo em Dados

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

Visão geral do TableAdapterManager