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
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 .
Selecione Banco de Dados como o tipo de fonte de dados e selecione Próximo.
Escolha DataSet e selecione Avançar.
Escolha um ou mais bancos de dados como conexão do seu conjunto de dados e selecione Avançar.
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.
Selecione Concluir.
O conjunto de dados aparece como um nó no Gerenciador de Soluções.
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.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.
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.
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.
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:
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.
Selecione a guia Fontes de Dados na margem esquerda do Visual Studio ou insira fontes de dados na caixa de pesquisa.
Clique com o botão direito do mouse no nó do conjunto de dados e selecione Configurar Fonte de Dados com Assistente.
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
Abra o conjunto de dados no Designer de Conjunto de Dados.
Arraste uma classe DataTable da guia DataSet da Caixa de Ferramentas para o Designer de Conjunto de Dados.
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.