Adicionar fontes de dados em aplicativos ADO.NET (.NET Framework)

Ao trabalhar com ferramentas de dados do .NET no Visual Studio, você pode adicionar fontes de dados (objetos .NET) para conectar seu aplicativo .NET a informações em armazenamentos de dados. Os designers do Visual Studio podem consumir a saída da fonte de dados para gerar código clichê que associa os dados aos formulários quando você arrasta e solta objetos de banco de dados da janela Fontes de Dados .

Exemplos de fontes de dados incluem:

• Uma classe em um modelo do Entity Framework associado a algum tipo de banco de dados

• Um conjunto de dados associado a algum tipo de banco de dados

• Uma classe que representa um serviço de rede, como um serviço de dados do Windows Communication Foundation (WCF) ou um serviço REST

• Uma classe que representa um serviço do SharePoint

• Uma classe ou coleção em sua solução

Pré-requisitos

• Um aplicativo que implementa objetos do Windows Forms ou WPF (Windows Presentation Format) direcionados ao .NET Framework. Você pode criar esse tipo de aplicativo com um modelo no Visual Studio quando sua instalação incluir a carga de trabalho de desenvolvimento do .NET Desktop. Para obter mais informações, consulte Modificar cargas de trabalho, componentes e pacotes de idiomas do Visual Studio.

  Importante

  Os recursos descritos neste artigo não são compatíveis com o desenvolvimento do .NET Core para WPF ou Windows Forms.

• O aplicativo deve usar recursos de associação de dados: conjuntos de dados, a Estrutura de Entidade, a LINQ (Consulta Integrada à Linguagem) para SQL, um serviço de dados WCF ou SharePoint.

  Dica

  Quando o aplicativo não usa um ou mais desses componentes, o conceito de uma "fonte de dados" não se aplica. Nesses cenários, você pode se conectar diretamente ao banco de dados usando objetos de classe SqlCommand .

Trabalhar com fontes de dados e formulários do Windows

Você cria e edita fontes de dados para o .NET Framework usando o Assistente de Configuração da Fonte de Dados em um aplicativo do Windows Forms ou do WPF. Você pode criar uma fonte de dados de um banco de dados, um serviço, um objeto ou uma lista do SharePoint:

Depois de criar fontes de dados, elas ficarão visíveis na janela Fontes de Dados . Quando o projeto estiver aberto no Visual Studio, você poderá acessar essa janela selecionando Exibir>Outras Fontes de Dados doWindows>. Você também pode usar o atalho de teclado Shift+Alt+D .

Em um projeto do Windows Forms direcionado ao .NET Framework (não ao .NET Core ou ao .NET 5 ou posterior), você pode arrastar uma fonte de dados da janela Fontes de Dados para uma superfície ou controle de design de formulário do Windows. Alguns exemplos de como você pode conectar uma fonte de dados com um formulário incluem:

• Arraste uma tabela para obter um BindingNavigator e um DataGridView para a tabela.

• Arraste uma coluna específica para obter um BindingNavigator com um Rótulo e TextBox para a coluna.

• Arraste todas as colunas da tabela para obter um formulário de exibição de dados completo para a tabela.

Essas ações disparam o Visual Studio para gerar código clichê que exibe os dados do armazenamento de dados. O exemplo a seguir mostra um conjunto de dados descarregado em um formulário do Windows. Se você selecionar F5 no aplicativo, os dados do banco de dados subjacente serão exibidos nos controles do formulário.

Criar fonte de dados do banco de dados ou do arquivo de banco de dados

Você pode criar um conjunto de dados ou um modelo do Entity Framework para usar como fonte de dados para um banco de dados ou arquivo de banco de dados com o Assistente de Configuração da Fonte de Dados. Se sua configuração usar o Entity Framework, primeiro crie suas classes de entidade e use o assistente para criar fontes de dados.

Criar conjunto de dados como fonte de dados

O Assistente de Configuração da Fonte de Dados fornece a opção de criar uma fonte de dados conectando-se a um banco de dados. Você pode escolher os objetos de banco de dados a serem usados como o conjunto de dados do aplicativo.

Siga estas etapas para criar um conjunto de dados como uma fonte de dados:

1. No Visual Studio, selecione Project>Add New Data Source para abrir o Assistente de Configuração da Fonte de Dados.

2. Para o tipo de fonte de dados, selecione Banco de Dados.

3. Para o modelo de banco de dados, selecione Conjunto de dados.

4. Siga os prompts para especificar uma conexão de banco de dados nova ou existente ou um arquivo de banco de dados.

5. Selecione os objetos de banco de dados a incluir no conjunto de dados e conclua o assistente.

Para obter instruções detalhadas para concluir o assistente, consulte Criar e configurar conjuntos de dados no .NET Framework com o Visual Studio.

Criar um modelo do Entity Framework como fonte de dados

Quando sua configuração usa o Entity Framework, primeiro você cria suas classes de entidade e, em seguida, usa o Assistente de Configuração da Fonte de Dados para criar a fonte de dados.

Siga estas etapas para criar um modelo do Entity Framework como uma fonte de dados com o Assistente de Modelo de Dados de Entidade:

1. Selecione Projeto>Adicionar novo item. A caixa de diálogo Adicionar Novo Item é aberta.

2. Na caixa de diálogo, selecione o modelo ADO.NET Modelo de Dados de Entidade , insira um nome para a instância do modelo e selecione Adicionar:

   

   O Assistente do Modelo de Dados de Entidade será aberto.

3. No assistente, escolha o método para gerar o modelo do Entity Framework:

   • Designer de EF a partir do banco de dados: Cria um modelo no Entity Framework Designer baseado em um banco de dados existente. Você pode escolher a conexão de banco de dados, as configurações do modelo e os objetos de banco de dados a serem incluídos no modelo. As classes com as quais seu aplicativo interage são geradas a partir do modelo.

   • Modelo de Designer EF vazio: cria um modelo vazio no Designer da Estrutura de Entidade como ponto de partida para projetar visualmente seu modelo. Posteriormente, você pode gerar um banco de dados a partir do seu modelo. As classes com as quais seu aplicativo interage são geradas a partir do modelo.

   • Modelo de Primeiro Código Vazio: cria um modelo de Code First vazio como ponto de partida para criar seu modelo usando código. Posteriormente, você pode gerar um banco de dados a partir do seu modelo.

   • Code First a partir do banco de dados: Cria um modelo Code First com base em um banco de dados existente. Você pode escolher a conexão de banco de dados, as configurações do modelo e os objetos de banco de dados a serem incluídos no modelo.

   

   Depois de escolher, selecione Avançar para continuar no assistente.

4. Adicione o modelo como a fonte de dados para seu aplicativo e conclua o assistente.

   Para instruções detalhadas sobre como concluir o assistente, consulte Criar classes de modelo com o Entity Framework (C#).

5. Depois de gerar classes para o modelo, você pode criar uma fonte de dados de um objeto com o Assistente de Configuração da Fonte de Dados.

   • Selecione as tabelas (ou colunas individuais), procedimentos armazenados, funções e exibições do modelo para uso no conjunto de dados.

     

   Para obter instruções detalhadas, consulte Criar fonte de dados do objeto.

Criar fonte de dados a partir do serviço

O Assistente de Configuração da Fonte de Dados dá suporte à criação de uma fonte de dados de um serviço. Nessa abordagem, o Visual Studio adiciona uma referência de serviço ao seu projeto e cria objetos proxy que correspondem aos objetos retornados pelo serviço. Quando um serviço retorna um conjunto de dados, o serviço é representado em seu projeto como um conjunto de dados. Se o serviço retornar um tipo específico, o serviço será representado em seu projeto como o tipo retornado.

Você pode criar uma fonte de dados dos seguintes tipos de serviços:

• Serviços de Dados do WCF

• Serviços do WCF

• Serviços Web

Siga estas etapas para criar uma fonte de dados de um serviço:

1. No Visual Studio, selecione Project>Add New Data Source para abrir o Assistente de Configuração da Fonte de Dados.

2. Para o tipo de fonte de dados, selecione Serviço.

   A caixa de diálogo Adicionar Referência de Serviço é aberta. Você também pode acessar essa caixa de diálogo clicando com o botão direito do mouse em seu projeto no Gerenciador de Soluções e selecionando Adicionar referência de serviço.

Para obter instruções detalhadas para concluir o assistente, consulte Criar e configurar conjuntos de dados no .NET Framework com o Visual Studio.

Criar fonte de dados do objeto

O Assistente de Configuração da Fonte de Dados também permite criar uma fonte de dados de qualquer objeto que exponha uma ou mais propriedades públicas.

Todas as propriedades públicas de um objeto são visíveis na janela Fontes de Dados . Se você estiver usando o Entity Framework com um modelo gerado, essa janela mostrará as classes de entidade que são as fontes de dados para seu aplicativo.

Siga estas etapas para criar uma fonte de dados de um objeto:

1. No Visual Studio, selecione Project>Add New Data Source para abrir o Assistente de Configuração da Fonte de Dados.

2. Para o tipo de fonte de dados, selecione Objeto.

3. Na página Selecionar objetos de dados , expanda os nós na exibição de árvore para localizar os objetos aos quais você deseja associar.

   A exibição de árvore contém nós para seu projeto e para assemblies e outros projetos referenciados pelo seu projeto.

   1. Para associar a um objeto em um assembly ou projeto que não aparece no modo de exibição de árvore, selecione Adicionar Referência.

   2. Utilize a caixa de diálogo Gerenciador de Referências para adicionar uma referência ao assembly ou projeto. Depois de adicionar a referência, o Visual Studio adiciona o assembly ou projeto à exibição de árvore.

   Observação

   Talvez seja necessário criar o projeto que contém seus objetos antes que os objetos apareçam no modo de exibição de árvore.

Para obter instruções detalhadas para concluir o assistente, consulte Criar e configurar conjuntos de dados no .NET Framework com o Visual Studio.

Criar fonte de dados na lista do SharePoint

Você também pode usar o Assistente de Configuração da Fonte de Dados para engradar uma fonte de dados de uma lista do SharePoint. O SharePoint expõe dados por meio dos Serviços de Dados do WCF, portanto, criar uma fonte de dados do SharePoint é o mesmo que criar uma fonte de dados de um serviço.

Siga estas etapas para criar uma fonte de dados de uma lista do SharePoint:

1. No Visual Studio, selecione Project>Add New Data Source para abrir o Assistente de Configuração da Fonte de Dados.

2. Para o tipo de fonte de dados, selecione SharePoint.

3. Use a caixa de diálogo Adicionar Referência de Serviço para se conectar ao serviço de dados do SharePoint apontando para o SharePoint Server.

Para obter instruções detalhadas para concluir o assistente, consulte Criar e configurar conjuntos de dados no .NET Framework com o Visual Studio.

Conteúdo relacionado

• Explorar as ferramentas de dados do Visual Studio para .NET
• Criar e configurar conjuntos de dados no .NET Framework com o Visual Studio