Passo a passo: criar um conjunto de dados para aplicativos do .NET Framework usando o Designer de Conjunto de Dados

Observação

Os conjuntos de dados 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. Eles são bastante úteis em 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, é recomendado que os novos aplicativos .NET usem o Entity Framework Core. O Entity Framework proporciona uma forma mais natural de trabalhar com dados tabulares como modelos de objeto e conta com uma interface de programação mais simples.

Neste passo a passo, você criará um conjunto de dados usando o Designer de Conjunto de Dados. O artigo leva você pelo processo de criação de um novo projeto e a adição de um novo item Conjunto de Dados a ele. Você aprenderá a criar tabelas com base em tabelas em um banco de dados sem usar um assistente.

Pré-requisitos

Para concluir este tutorial, você precisa da carga de trabalho de Desenvolvimento de área de trabalho do .NET (para a janela Fontes de dados) e da carga de trabalho Armazenamento e processamento de dados instaladas no Visual Studio. Para instalá-las, abra Instalador do Visual Studio e escolha Modificar (ou Mais>Modificar) ao lado da versão do Visual Studio que você deseja modificar. Confira Modificar o Visual Studio.

Este passo a passo usa o SQL Server Express LocalDB e o banco de dados de exemplo da Northwind.

  1. Se você não tiver SQL Server Express LocalDB, instale-o por meio da página de download do SQL Server Express ou usando o Instalador do Visual Studio. No Instalador do Visual Studio, o SQL Server Express LocalDB pode ser instalado como parte da carga de trabalho Armazenamento e processamento de dados ou como um componente individual.

  2. Instale o banco de dados de exemplo da Northwind seguindo estas etapas:

    1. No Visual Studio, abra a janela Pesquisador de Objetos do SQL Server. (O Pesquisador de Objetos do SQL Server é instalado como parte da carga de trabalho Armazenamento e processamento de dados no Instalador do Visual Studio). Expanda o nó do SQL Server. Clique com o botão direito do mouse na instância do LocalDB e selecione Nova Consulta.

      Uma janela do editor de consultas vai se abrir.

    2. Copie o script Transact-SQL da Northwind para sua área de transferência. Esse script T-SQL cria o banco de dados da Northwind do zero e o preenche com alguns dados.

    3. Cole o script T-SQL no editor de consultas e escolha o botão Executar.

      Após um curto período de tempo, a consulta termina de ser executada e o banco de dados Northwind é criado.

Criar um novo projeto de aplicativo do Windows Forms

  1. No Visual Studio, crie um projeto do Aplicativo do Windows Forms (.NET Framework) e nomeie-o DatasetDesignerWalkthrough.

    O Visual Studio adiciona o projeto ao Gerenciador de Soluções e exibe um novo formulário no designer.

Adicionar um novo Conjunto de Dados ao aplicativo

  1. No menu Projeto, selecione Adicionar novo item.

    A caixa de diálogo Adicionar Novo Item aparecerá.

  2. No painel esquerdo, selecione Dados e Conjunto de Dados no painel central.

  3. Nomeie o Conjunto de Dados como NorthwindDataset e escolha Adicionar.

    O Visual Studio adiciona um arquivo chamado NorthwindDataset.xsd ao projeto e o abre no Designer de Conjunto de Dados.

Criar uma conexão de dados no Gerenciador de Servidores

  1. No menu Exibir, clique em Gerenciador de Servidores.

  2. No Gerenciador de Servidores, clique no botão Conectar ao Banco de Dados.

  3. Criar uma conexão ao banco de dados de exemplo Northwind.

Criar as tabelas no conjunto de dados

Esta seção explica como adicionar tabelas ao conjunto de dados.

Para criar a tabela Customers

  1. Expanda a conexão de dados que você criou no Gerenciador de Servidores e expanda o nó Tabelas.

  2. Arraste a tabela Clientes do Gerenciador de Servidores para o Designer de Conjunto de Dados.

    Tabelas de dados Clientes e CustomersTableAdapter são adicionadas ao conjunto de dados.

Para criar a tabela Orders

  • Arraste a tabela Pedidos do Gerenciador de Servidores para o Designer de Conjunto de Dados.

    Uma tabela de dados Pedidos, OrdersTableAdapter e a relação de dados entre as tabelas Clientes e Pedidos são adicionadas ao conjunto de dados.

Para criar a tabela Detalhes do Pedido

  • Arraste a tabela Detalhes do Pedido do Gerenciador de Servidores para o Designer de Conjunto de Dados.

    Uma tabela de dados Detalhes do Pedido, OrderDetailsTableAdapter e uma relação de dados entre as tabelas Pedidos e Detalhes do Pedido são adicionadas ao conjunto de dados.

Salvar o conjunto de dados

O conjunto de dados recém-criado está disponível na janela Fontes de Dados. Se não estiver vendo a janela Fontes de dados, verifique se a carga de trabalho Armazenamento e processamento de dados está instalada conforme mencionado nos Pré-requisitos.

Agora é possível realizar qualquer uma das seguintes tarefas: