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 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 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
.gif "Observação") Observaçã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 do Visual Studio. |
Para ativar a atualização hierárquica em versões anteriores de datasets tipados
Abra o projeto que contém um dataset tipado ou conjuntos de dados Visual Studio.
Conclua o Visual Studio Conversion Wizard.
Abra o dataset no Dataset Designer por duas vezes no arquivo. xsd no Solution Explorer.
Clique em uma área vazia no Dataset Designer.
Localize a propriedade Hierarchical Update na Janela de Propriedades.
Defina o valor da propriedade Hierarchical Update como True.
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
Localize o código que chama os métodos TableAdapter.Update (por exemplo, CustomersTableAdapter.Update(NorthwindDataSet.Customers)).
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
Abra o formulário no modo de design.
Arraste um componente TableAdapterManager do ToolBox para o formulário.
Localize o código que chama os métodos TableAdapter.Update (por exemplo, CustomersTableAdapter.Update(NorthwindDataSet.Customers)).
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 no desenvolvimento de aplicativos de dados