Instruções passo a passo: preenchendo um conjunto de dados com Dados
Este passo a passo cria um conjunto de dados com uma tabela de dados e o preenche com dados da tabela Customers no banco de dados de exemplo Northwind. O conjunto de dados é preenchido com dados chamando o método Fill de um TableAdapter.
Durante este passo a passo, você aprenderá a:
Criar um novo Aplicativo do Windows.
Criar e configurar um dataset com o Assistente para Configuração da Fonte de Dados.
Crie um DataGridView de associação de dados arrastando itens da janela Fontes de Dados para um formulário.
Para concluir este passo a passo, você precisará de:
- Acesso ao banco de dados de exemplo Northwind. Para obter mais informações, consulte Como instalar bancos de dados de exemplo.
A primeira etapa é criar um Aplicativo do Windows.
No Visual Studio, no menu Arquivo, crie um novo Projeto.
Nomeie o projeto DatasetWalkthrough.
Selecione Aplicativo do Windows e clique em OK. Para obter mais informações, consulte Implementando aplicativos cliente com o .NET Framework.
O projeto DatasetWalkthrough é criado e adicionado ao Gerenciador de Soluções.
Esta etapa cria um conjunto de dados usando o Assistente de Configuração de Fonte de Dados baseado na tabela Customers no banco de dados de exemplo Northwind. É preciso ter acesso ao banco de dados de exemplo Northwind para criar a conexão. Para obter informações sobre como configurar o banco de dados de exemplo Northwind, consulte Como instalar bancos de dados de exemplo.
No menu Dados, clique em Mostrar Fontes de Dados.
Na janela Fontes de Dados, clique em Adicionar Nova Fonte de Dados para iniciar o Assistente de Configuração de Fonte de Dados.
Selecione Base de dados na página Escolher um Tipo de Fonte de Dados e, em seguida, clique em Próximo.
Sobre o Escolha sua conexão de dados página faça o seguinte:
Se uma conexão de dados no banco de dados de exemplo Northwind estiver disponível na lista suspensa, selecione-o.
-ou-
Selecione nova conexão para iniciar o Adicionar/Modificar conexão caixa de diálogo.
Se o banco de dados exigir uma senha, selecione a opção para incluir dados confidenciais e, em seguida, clique em Próximo.
Clique em Avançar na página Salvar cadeia de caracteres de conexão no arquivo de configuração do aplicativo.
Expanda o nó Tabelas na página Escolher Objetos do Banco de Dados.
Selecione a tabela Clientes e clique em Concluir.
O NorthwindDataSet é adicionado ao projeto e a tabela Customers aparece na janela Fontes de Dados.
Você pode criar controles de associação de dados arrastando itens da janela Fontes de Dados para um formulário em seu aplicativo do Windows.
Arraste o nó principal Clientes da janela Fontes de Dados para Form1.
Um controle DataGridView e uma faixa de ferramentas (BindingNavigator) para navegação em registros são exibidos no formulário. Um NorthwindDataSet, CustomersTableAdapter, BindingSource e BindingNavigator são exibidos na bandeja de componentes.
Arrastar itens da janela Fontes de Dados para um formulário adiciona automaticamente o código correto para preencher o conjunto de dados no manipulador de eventos Form1_Load.
No Gerenciador de Soluções , selecione o Form1 e clique no botão Exibir Código.
Inspecione o manipulador de eventos Form1_Load. O método Fill do TableAdapter preenche o conjunto de dados com os dados.
Private Sub Form1_Load() Handles MyBase.Load 'TODO: This line of code loads data into the 'NorthwindDataSet1.Customers' table. 'You can move, or remove it, as needed. Me.CustomersTableAdapter1.Fill(Me.NorthwindDataSet1.Customers) End Sub
private void Form1_Load(object sender, EventArgs e) { // TODO: This line of code loads data into the 'northwindDataSet1.Customers' table. // You can move, or remove it, as needed. this.customersTableAdapter1.Fill(this.northwindDataSet1.Customers); }
Se desejar, você pode copiar esse código para outras partes do seu aplicativo, para preencher o conjunto de dados.
Pressione F5 para executar o aplicativo.
O conjunto de dados é preenchido com os dados e é exibido no DataGridView.
Dependendo dos requisitos do aplicativo, existem várias etapas que você talvez queira realizar após criar um formulário de associação de dados. Entre algumas das melhorias que você poderia fazer nessa explicação passo a passo estão:
Adicionando funcionalidade de busca ao formulário. Para obter mais informações, consulte Como adicionar uma consulta parametrizada a um aplicativo dos Windows Forms.
Adicionando a funcionalidade para enviar atualizações de volta ao banco de dados. Para obter mais informações, consulte Instruções passo a passo: salvando dados em um banco de dados (tabela única).
Adicionar a tabela Orders ao conjunto de dados, selecionando Configurar DataSet com Assistente na janela Fontes de Dados. Agora adicione os controles que exibem dados relacionados, arrastando o nó Pedidos (abaixo da coluna Fax no dentro da tabela Clientes) para o formulário. Para obter mais informações, consulte Como exibir dados relacionados em um aplicativo dos Windows Forms.
Associando controles dos Windows Forms a dados no Visual Studio
Preparando o aplicativo para receber dados
Associando controles a dados no Visual Studio
Instruções passo a passo de dados