Compartilhar via


Criar e configurar conjuntos de dados no .NET Framework usando o Visual Studio

Nota

Conjuntos de dados e classes relacionadas são tecnologias herdadas do .NET Framework do início dos anos 2000 que permitem que os aplicativos trabalhem com dados na memória enquanto os aplicativos são desconectados do banco de dados. As tecnologias são especialmente úteis para aplicativos que permitem que os usuários modifiquem dados e persistam as alterações no banco de dados. Embora os conjuntos de dados tenham se mostrado uma tecnologia muito bem-sucedida, recomendamos que novos aplicativos .NET usem Entity Framework Core. O Entity Framework fornece uma maneira mais natural de trabalhar com dados tabulares como modelos de objeto e tem uma interface de programação mais simples.

Um conjunto de dados é um conjunto de objetos que armazenam dados de um banco de dados na memória e dão suporte ao controle de alterações para habilitar operações CRUD (criar, ler, atualizar e excluir) nesses dados sem a necessidade de estar sempre conectado ao banco de dados. Para trabalhar com conjuntos de dados, você deve ter um conhecimento básico dos conceitos de banco de dados.

Você pode criar uma classe do tipo DataSet no Visual Studio em tempo de desenvolvimento usando o Assistente de Configuração da Fonte de Dados . Para obter informações sobre como criar conjuntos de dados programaticamente, consulte Criar um conjunto de dados.

Pré-requisitos

  • Visual Studio com as cargas de trabalho do Desenvolvimento do .NET para desktop e do Armazenamento e processamento de dados instaladas. Para instalá-los, abra do Instalador do Visual Studio e escolha Modificar ao lado da versão do Visual Studio que você deseja modificar.

  • Um projeto do .NET Framework. Não use o .NET Core ou o .NET 5 ou posterior.

  • SQL Server Express LocalDB. Se você não tiver o SQL Server Express LocalDB, poderá instalá-lo na página de download do SQL Server.

Criar um novo conjunto de dados usando o Assistente de Configuração da Fonte de Dados

  1. Abra seu projeto no Visual Studio e, em seguida, escolha Project>Adicionar nova fonte de dados para iniciar o Assistente de Configuração da Fonte de Dados .

  2. Selecione Banco de Dados como o tipo de fonte de dados e selecione Próximo.

    Captura de tela que mostra o Assistente de Configuração da Fonte de Dados.

  3. Escolha DataSet e selecione Avançar.

    Captura de tela que mostra como escolher o DataSet como o modelo de banco de dados.

  4. Escolha um ou mais bancos de dados como conexão do seu conjunto de dados e selecione Avançar.

    captura de tela que mostra como selecionar um banco de dados como uma fonte de dados.

  5. Escolha as tabelas (ou colunas individuais), exibições, procedimentos armazenados e funções do banco de dados que você deseja representar no conjunto de dados.

    Captura de tela que mostra como escolher seus objetos de banco de dados.

  6. Selecione Concluir.

    O conjunto de dados aparece como um nó no Gerenciador de Soluções.

    Captura de tela que mostra como o conjunto de dados aparece no Gerenciador de Soluções.

  7. Clique duas vezes no nó do conjunto de dados no Gerenciador de Soluções.

    O conjunto de dados é aberto no Designer de Conjunto de Dados.

    Cada tabela no conjunto de dados tem um objeto TableAdapter associado, que é representado na parte inferior do diagrama da tabela. O adaptador de tabela é usado para preencher o conjunto de dados e, opcionalmente, para enviar comandos para o banco de dados.

    Captura de tela que mostra as tabelas de dados no Designer de Conjunto de Dados.

  8. Se você quiser alterar o comportamento das atualizações hierárquicas, clique duas vezes em uma linha de relação entre duas tabelas para exibir a caixa de diálogo relação.

    As linhas de relação que conectam as tabelas representam relações de tabela, conforme definido no banco de dados. Por padrão, as restrições de chave estrangeira em um banco de dados são representadas apenas como uma relação, com as regras de atualização e exclusão definidas como nenhuma, que normalmente é o que você deseja. Para obter mais informações, consulte Criar relações entre conjuntos de dados e Atualização hierárquica.

    Captura de tela que mostra a caixa de diálogo Relação em que você pode editar a relação do conjunto de dados.

  9. No Designer de Conjunto de Dados, selecione uma tabela, um adaptador de tabela ou um nome de coluna para ver suas propriedades na janela Propriedades. Embora você possa modificar alguns dos valores na janela, lembre-se de que você está modificando o conjunto de dados, não o banco de dados de origem.

    captura de tela que mostra as propriedades da coluna DataSet.

  10. Você pode adicionar novas tabelas ou adaptadores de tabela ao conjunto de dados, adicionar novas consultas para adaptadores de tabela existentes ou especificar novas relações entre tabelas arrastando esses itens da guia da caixa de ferramentas esquerda. Essa guia é exibida quando o Designer de Conjunto de Dados está em foco.

    Captura de tela que mostra a Caixa de Ferramentas do Conjunto de Dados.

  11. Opcionalmente, talvez você queira especificar como preencher o conjunto de dados com dados. Para fazer isso, use o Assistente de Configuração do TableAdapter . Para obter mais informações, consulte Preencher conjuntos de dados usando TableAdapters.

Adicionar uma tabela de banco de dados ou outro objeto a um conjunto de dados existente

Este procedimento mostra como adicionar uma tabela do mesmo banco de dados usado para criar primeiro o conjunto de dados:

  1. Clique duas vezes no nó do conjunto de dados no Gerenciador de Soluções.

    O conjunto de dados é aberto no Designer de Conjunto de Dados.

  2. Selecione a guia Fontes de Dados na margem esquerda do Visual Studio ou insira fontes de dados na caixa de pesquisa.

  3. Clique com o botão direito do mouse no nó do conjunto de dados e selecione Configurar Fonte de Dados com Assistente.

    Captura de tela que mostra o menu de contexto da Fonte de Dados.

  4. Use o Assistente de Configuração da Fonte de Dados para especificar quais tabelas adicionais, procedimentos armazenados ou outros objetos de banco de dados adicionar ao conjunto de dados.

Adicionar uma tabela de dados autônoma a um conjunto de dados

  1. Abra o conjunto de dados no Designer de Conjunto de Dados.

  2. Arraste uma classe DataTable da guia DataSet da Caixa de Ferramentas para o Designer de Conjunto de Dados.

  3. Adicione colunas para definir sua tabela de dados. Clique com o botão direito do mouse na tabela e escolha Adicionar>Coluna. Na janela Propriedades, defina o tipo de dados da coluna. Se necessário, adicione uma chave selecionando Adicionar>Chave.

As tabelas independentes precisam implementar a lógica Fill para poder preenchê-las com dados. Para obter informações sobre como preencher tabelas de dados, veja Preencher um DataSet de um DataAdapter.