Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Note
A DataSet classe e as 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 estão desconectados do banco de dados. As tecnologias são especialmente úteis para aplicativos que permitem aos usuários modificar dados e manter as alterações de volta ao banco de dados. Embora os conjuntos de dados sejam uma tecnologia comprovadamente bem-sucedida, a abordagem recomendada para novos aplicativos .NET é usar o 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 oferecem suporte ao controle de alterações para permitir operações de criação, leitura, atualização e exclusão (CRUD) 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 de conceitos de banco de dados.
Pode criar uma classe tipada DataSet no Visual Studio em tempo de design usando o Assistente de Configuração de Fonte de Dados. Para obter informações sobre como criar conjuntos de dados programaticamente, consulte Criar um conjunto de dados.
Prerequisites
Visual Studio com as cargas de trabalho de desenvolvimento de aplicações desktop .NET e armazenamento e processamento de dados instaladas. Para instalá-los, abra Visual Studio Installer e escolha Modificar ao lado da versão do Visual Studio que você deseja modificar.
Um projeto .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 a partir da 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 escolha Project>Add New Data Source para iniciar o Assistente de Configuração de Fonte de Dados .
Selecione Banco de Dados como o tipo de fonte de dados e, em seguida, selecione Avançar.
Escolha DataSete, em seguida, selecione Avançar.
Escolha um ou mais bancos de dados como a conexão de dados para 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 Dataset Designer.
Cada tabela no conjunto de dados tem um objeto
TableAdapterassociado, que é representado na parte inferior do diagrama de tabela. O adaptador de tabela é usado para preencher o conjunto de dados e, opcionalmente, para enviar comandos para o banco de dados.
Se desejar 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 Conjuntos de Dados, selecione uma tabela, adaptador de tabela ou nome de coluna para ver as suas propriedades na janela Propriedades. Embora você possa modificar alguns dos valores na janela, lembre-se de que 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 aba Caixa de Ferramentas à esquerda. Esta aba aparece quando o Dataset Designer está em foco.
Opcionalmente, convém especificar como preencher o conjunto de dados com dados. Para tal efeito, 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 que você usou 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 Dataset Designer.
Selecione o separador 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 o 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 devem ser adicionados ao conjunto de dados.
Adicionar uma tabela de dados autônoma a um conjunto de dados
Abra o conjunto de dados no Dataset Designer.
Arraste uma classe DataTable da guia DataSet do Caixa de Ferramentas para o Dataset Designer.
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 autónomas precisam implementar a lógica Fill para que se possa preenchê-las com dados. Para obter informações sobre como preencher tabelas de dados, consulte preencher um DataSet a partir de um DataAdapter.