Compartilhar via


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

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.

Observação

Os recursos descritos neste artigo se aplicam ao .NET Framework Windows Forms e ao desenvolvimento do WPF. Não há suporte para os recursos para desenvolvimento do .NET Core, tanto para o WPF quanto para Windows Forms.

No contexto das ferramentas de dados do .NET no Visual Studio, o termo fonte de dados refere-se a objetos .NET que se conectam a um armazenamento de dados e disponibilizam os dados para um aplicativo .NET. Os designers do Visual Studio podem consumir a saída da fonte de dados para gerar o código clichê que associa os dados aos formulários quando você arrasta e remove objetos de banco de dados da janela Fontes de Dados. Esse tipo de fonte de dados pode ser:

  • Uma classe em um modelo do Entity Framework que está 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 WCF (Windows Communication Foundation) ou um serviço REST.

  • Uma classe que representa um serviço do SharePoint.

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

Observação

Se você não estiver usando recursos de associação de dados, conjuntos de dados, Entity Framework, LINQ to SQL, WCF ou SharePoint, o conceito de "fonte de dados" não se aplicará. Basta conectar-se diretamente ao banco de dados usando os objetos SQLCommand e comunicar-se diretamente com o banco de dados.

Você cria e edita fontes de dados usando o Assistente de Configuração da Fonte de Dados em um aplicativo Windows Forms ou Windows Presentation Foundation. Para o Entity Framework, primeiro crie suas classes de entidade e inicie o assistente selecionando Projeto>Adicionar Nova Fonte de Dados (descrito mais detalhadamente mais adiante neste artigo).

Assistente para Configuração da Fonte de Dados

janela Fontes de Dados

Depois de criar uma fonte de dados, ela será exibida na janela ferramenta Fontes de Dados .

Dica

Para abrir a janela Fontes de Dados, verifique se o projeto está aberto e pressione Shift+Alt+D ou escolha Exibir>Outras Fontes de Dados do>Windows.

Em um projeto de Windows Forms direcionado à .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. Se você arrastar uma tabela, obterá um BindingNavigator e um DataGridView para a tabela. Se você arrastar uma coluna individual, obterá um BindingNavigator e um Label e um TextBox para essa coluna. Arraste as colunas para obter um formulário de exibição de dados completo para uma tabela. Essas ações fazem com que o código clichê seja gerado que exibe os dados do armazenamento de dados.

A ilustração a seguir mostra um conjunto de dados que foi descartado 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.

Captura de tela mostrando a operação de arrastar fonte de dados.

Captura de tela mostrando a operação de arrastar fonte de dados.

Fonte de dados para um banco de dados ou um 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.

Dataset

Para criar um conjunto de dados como uma fonte de dados, execute o Assistente de Configuração da Fonte de Dados selecionando Projeto>Adicionar Nova Fonte de Dados. Escolha o tipo de fonte de dados banco de dados e siga as solicitações para especificar uma conexão de banco de dados nova ou existente ou um arquivo de banco de dados.

Classes de entidade

Para criar um modelo do Entity Framework como uma fonte de dados:

  1. Execute o Assistente de Modelo de Dados de Entidade para criar as classes de entidade. Selecione Projeto>Adicionar Novo Item>ADO.NET Modelo de Dados de Entidade.

    Novo item de projeto de modelo do Entity Framework

  2. Escolha o método pelo qual você deseja gerar o modelo.

    Assistente do Modelo de Dados de Entidade

  3. Adicionar o modelo como uma fonte de dados. As classes geradas aparecem no Assistente de Configuração da Fonte de Dados quando você escolhe a categoria Objetos.

    Assistente de Configuração da Fonte de Dados com Classes de Entidade

Fonte de dados de um serviço

Para criar uma fonte de dados de um serviço, execute o Assistente de Configuração da Fonte de Dados e escolha o Tipo de fonte de dados de Serviço. Essa ação é apenas um atalho para a caixa de diálogo Adicionar Referência de Serviço, que você também pode acessar clicando com o botão direito do mouse no projeto em Gerenciador de Soluções e selecionando Adicionar referência de serviço.

Quando você cria uma fonte de dados de um serviço, o Visual Studio adiciona uma referência de serviço ao seu projeto. O Visual Studio também cria objetos proxy que correspondem aos objetos que o serviço retorna. Por exemplo, um serviço que retorna um conjunto de dados é representado em seu projeto como um conjunto de dados; um serviço que retorna um tipo específico é representado em seu projeto conforme o tipo retornado.

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

  • WCF Data Services

  • Serviços WCF

  • Serviços da Web

    Observação

    Os itens que aparecem na janela Fontes de Dados são dependentes dos dados que o serviço retorna. Alguns serviços podem não fornecer informações suficientes para o Assistente de Configuração de Fonte de Dados criar objetos associáveis. Por exemplo, se o serviço retornar um conjunto de dados não tipado, nenhum item aparecerá na janela Fontes de Dados quando você concluir o assistente. Isso ocorre porque os conjuntos de dados não tipados não fornecem esquema, portanto, o assistente não tem informações suficientes para criar a fonte de dados.

Fonte de dados de um objeto

Você pode criar uma fonte de dados de qualquer objeto que exponha uma ou mais propriedades públicas executando o Assistente de Configuração da Fonte de Dados e selecionando o tipo de fonte de dados Object. Todas as propriedades públicas de um objeto são exibidas na janela Fontes de Dados. Se você estiver usando o Entity Framework e tiver gerado um modelo, é aqui que você encontra as classes de entidade que são as fontes de dados para seu aplicativo.

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 que são referenciados pelo seu projeto.

Se você quiser associar a um objeto em um assembly ou projeto que não aparece no modo de exibição de árvore, clique em Adicionar Referência e use a Caixa de Diálogo Adicionar Referência para adicionar uma referência ao assembly ou projeto. Depois de adicionar a referência, o assembly ou projeto é adicionado à 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.

Observação

Para dar suporte à associação de dados de arrastar e soltar, os objetos que implementam a interface ITypedList ou IListSource devem ter um construtor padrão. Caso contrário, o Visual Studio não poderá instanciar o objeto de fonte de dados e ele exibirá um erro quando você arrastar o item para a superfície de design.

Fonte de dados de uma lista do SharePoint

Você pode criar uma fonte de dados de uma lista do SharePoint executando o Assistente de Configuração da Fonte de Dados e selecionando o tipo de fonte de dados do SharePoint. O SharePoint expõe dados por meio de WCF Data Services, portanto, criar uma fonte de dados do SharePoint é o mesmo que criar uma fonte de dados de um serviço. Selecionar o item do SharePoint no Assistente de Configuração da Fonte de Dados abre a caixa de diálogo Adicionar Referência de Serviço, na qual você se conecta ao serviço de dados do SharePoint apontando para o servidor do SharePoint. Essa ação requer o SDK do SharePoint.