Compartilhar via


Conectar-se a um banco de dados do Access em aplicativos do .NET Framework

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.

Você pode se conectar a um banco de dados do Access (um arquivo .mdb ou um arquivo .accdb) usando o Visual Studio. Depois de definir a conexão, os dados serão exibidos na janela Fontes de Dados. A partir daí, você pode arrastar tabelas ou exibições para sua superfície de design.

Nota

Se você estiver usando o Visual Studio para se conectar aos bancos de dados do Access, precisará estar ciente de que as versões do Visual Studio anteriores ao Visual Studio 2022 são todos processos de 32 bits. Isso significa que algumas das ferramentas de dados no Visual Studio 2019 e anteriores só poderão se conectar aos bancos de dados do Access usando provedores de dados de 32 bits.

Se você estiver usando o Visual Studio 2022 para se conectar aos bancos de dados do Access, precisará estar ciente de que o Visual Studio 2022 agora é um processo de 64 bits. Isso significa que algumas das ferramentas de dados no Visual Studio não poderão se conectar aos bancos de dados do Access usando provedores de dados de 32 bits.

Se você precisar manter aplicativos de 32 bits que se conectam aos bancos de dados do Access, você ainda poderá criar e executar o aplicativo com o Visual Studio 2022. No entanto, se você precisar usar qualquer uma das Ferramentas de Dados do Visual Studio, como o Gerenciador de Servidores, o Assistente de Fonte de Dados ou o Designer de Conjunto de Dados, será necessário usar uma versão anterior do Visual Studio que ainda seja um processo de 32 bits. A última versão do Visual Studio que foi um processo de 32 bits foi o Visual Studio 2019.

Se você planeja converter o projeto para ser um processo de 64 bits, é recomendável usar o Mecanismo de Banco de Dados do Microsoft Access de 64 bits, também chamado ACE (Mecanismo de Conectividade de Acesso). Confira Provedor OLE DB para Jet e Driver ODBC são versões exclusivas de 32 bits para obter mais informações.

Pré-requisitos

Para usar esses procedimentos, você precisa:

  • Visual Studio
  • Um projeto do Windows Forms ou do WPF
  • Um banco de dados do Access (arquivo.accdb) ou um banco de dados do Access 2000–2003 (arquivo.mdb). Siga o procedimento que corresponde ao tipo de arquivo.

Criar um conjunto de dados para um arquivo .accdb

Conecte-se a bancos de dados criados com o Microsoft 365, Access 2016, Access 2013, Access 2010 ou Access 2007 usando o procedimento a seguir.

  1. Abra um projeto de aplicativo do Windows Forms ou do WPF no Visual Studio.

  2. Para abrir a janela de Fontes de Dados , pressione Ctrl+Q, insira "data" na caixa de pesquisa e escolha a janela Fontes de Dados . Ou, no menu Exibir, selecione Outras Fontes de Dados do Windows>. Ou, no teclado, pressione Shift+Alt+D.

    captura de tela Captura de tela de fontes de dados na caixa de pesquisa

  3. Na janela de Fontes de Dados, clique em Adicionar Nova Fonte de Dados.

    O Assistente de Configuração de Fonte de Dados é aberto.

    Captura de tela mostrando o Assistente de Configuração da Fonte de Dados

  4. Selecione Banco de Dados na página Escolher um Tipo de Fonte de Dados e selecione Avançar.

  5. Selecione Conjunto de dados na página Escolher um Modelo de Banco de Dados e, em seguida, selecione Avançar.

    Captura de tela da página Escolher um Modelo de Banco de Dados

  6. Na página Escolher a Conexão de Dados, selecione Nova Conexão para configurar uma nova conexão de dados.

    Captura de tela da página Escolher Sua Conexão de Dados

    A caixa de diálogo Adicionar Conexão é aberta.

    Captura de tela da caixa de diálogo Adicionar Conexão

  7. Se Fonte de dados não estiver definido como Arquivo de Banco de Dados do Microsoft Access, selecione o botão Alterar.

    A caixa de diálogo Alterar Fonte de Dados é aberta. Na lista de fontes de dados, escolha Arquivo de Banco de Dados do Microsoft Access. A opção provedor de dados do .NET Framework para o OLE DB já está pré-selecionada. Escolha OK.

    Captura de tela da caixa de diálogo Escolher Fonte de Dados

  8. Selecione Procurar ao lado de Nome do arquivo de banco de dados, navegue até o arquivo .accdb e selecione Abrir.

    Nota

    Se as versões (32 bits ou 64 bits) do Microsoft Office e do Visual Studio não corresponderem, você verá um erro ao se conectar a um banco de dados do Access. No Visual Studio 2019, você receberá um erro de que o provedor de banco de dados não está registrado. No Visual Studio 2022, você verá um erro que não pode se conectar a um provedor de dados de 32 bits. Para resolver esse erro, verifique se você está usando uma versão de 32 bits do Office, está usando o Visual Studio 2019 ou anterior; para uma versão de 64 bits do Office, você precisa do Visual Studio 2022 ou posterior.

  9. Insira um nome de usuário e senha (se necessário) e escolha OK.

  10. Selecione Avançar na página Escolher a Conexão de Dados.

    Você pode obter uma caixa de diálogo informando que o arquivo de dados não está em seu projeto atual. Selecione Sim ou Sem.

  11. Selecione Avançar na página Salvar cadeia de conexão no arquivo de Configuração de Aplicativo.

    Captura de tela da página

  12. Expanda o nó Tabelas na página Escolher Objetos do Banco de Dados.

    Captura de tela da página Escolher objetos de banco de dados

  13. Selecione as tabelas ou visões que você deseja incluir no conjunto de dados e selecione Finalizar.

    O conjunto de dados é adicionado ao seu projeto, e as tabelas e visões aparecem na janela de Fontes de Dados .

    Captura de tela da janela Fontes de Dados, preenchida com objetos de banco de dados

  14. Em computadores de 64 bits com o mecanismo de banco de dados do Access de 64 bits, você precisa garantir que o aplicativo seja executado como um aplicativo de 64 bits. Abra as propriedades do projeto (pressione Alt+Enter ou clique com o botão direito do mouse no nó do projeto e selecione Propriedades). Na guia Criar, desmarque a caixa de seleção Preferir 32 bits.

A cadeia de conexão é armazenada em app.confige no arquivo Settings.settings em Properties no Gerenciador de Soluções.

Criar um conjunto de dados para um arquivo .accdb

Conecte-se a bancos de dados criados com o Microsoft 365, Access 2016, Access 2013, Access 2010 ou Access 2007 usando o procedimento a seguir.

  1. Abra um projeto de aplicativo do Windows Forms ou do WPF no Visual Studio.

  2. Para abrir a janela Fontes de Dados, pressione Ctrl+Q, insira "dados" na caixa de pesquisa e escolha a janela Fontes de Dados. Ou, no menu Exibir, selecione Outras Fontes de Dados do Windows>. Ou, no teclado, pressione Shift+Alt+D.

    exibir outras fontes de dados do Windows

  3. Na janela Fontes de Dados, clique em Adicionar Nova Fonte de Dados.

    O Assistente de Configuração de Fonte de Dados é aberto.

  4. Selecione Banco de Dados na página Escolher um Tipo de Fonte de Dados e selecione Avançar.

  5. Selecione Conjunto de dados na página Escolher um Modelo de Banco de Dados e, em seguida, selecione Avançar.

    Captura de tela da página Escolher um Modelo de Banco de Dados

  6. Na página Escolher a Conexão de Dados, selecione Nova Conexão para configurar uma nova conexão de dados.

    Captura de tela da página Escolher Sua Conexão de Dados

    A caixa de diálogo Adicionar Conexão é aberta.

    Captura de tela da caixa de diálogo Adicionar Conexão

  7. Se Fonte de dados não estiver definido como Arquivo de Banco de Dados do Microsoft Access, selecione o botão Alterar.

    A caixa de diálogo Alterar Fonte de Dados é aberta. Na lista de fontes de dados, escolha Arquivo de Banco de Dados do Microsoft Access. A opção provedor de dados do .NET Framework para o OLE DB já está pré-selecionada. Escolha OK.

    Captura de tela da caixa de diálogo Escolher Fonte de Dados

  8. Selecione Procurar ao lado de Nome do arquivo de banco de dados, navegue até o arquivo .accdb e selecione Abrir.

    Nota

    Se a versão (32 bits ou 64 bits) do Microsoft Office e do Visual Studio não forem compatíveis, você verá um erro ao se conectar a um banco de dados do Access. No Visual Studio 2019, você receberá um erro de que o provedor de banco de dados não está registrado. No Visual Studio 2022, você verá um erro que não pode se conectar a um provedor de dados de 32 bits. Para resolver esse erro, verifique se você está usando uma versão de 32 bits do Office, está usando o Visual Studio 2019 ou anterior; para uma versão de 64 bits do Office, você precisa do Visual Studio 2022 ou posterior.

  9. Insira um nome de usuário e senha (se necessário) e escolha OK.

  10. Selecione Avançar na página Escolher a Conexão de Dados.

    Você pode obter uma caixa de diálogo informando que o arquivo de dados não está em seu projeto atual. Selecione Sim ou Sem.

  11. Selecione Avançar na página Salvar cadeia de conexão no arquivo de Configuração de Aplicativo.

    Captura de tela da página

  12. Expanda o nó Tabelas na página Escolher Objetos do Banco de Dados.

  13. Selecione as tabelas ou visualizações que você deseja incluir no conjunto de dados e selecione Finalizar.

    O Conjunto de Dados é adicionado ao projeto e as tabelas e as exibições são mostradas na janela Fontes de Dados.

Criar um conjunto de dados para um arquivo .mdb

Conecte-se aos bancos de dados criados com o Access 2000-2003 usando o procedimento a seguir.

  1. Abra um projeto de aplicativo do Windows Forms ou do WPF no Visual Studio.

  2. No menu Exibir, selecione Outras Fontes de Dados do Windows>.

  3. Na janela Fontes de Dados, clique em Adicionar Nova Fonte de Dados.

    O Assistente de Configuração de Fonte de Dados é aberto.

  4. Selecione Banco de Dados na página Escolher um Tipo de Fonte de Dados e selecione Avançar.

  5. Selecione Conjunto de dados na página Escolher um Modelo de Banco de Dados e, em seguida, selecione Avançar.

  6. Na página Escolher a Conexão de Dados, selecione Nova Conexão para configurar uma nova conexão de dados.

  7. Se a fonte de dados não for um Arquivo de Banco de Dados do Microsoft Access (OLE DB), selecione Alterar para abrir a caixa de diálogo Alterar Fonte de Dados e selecione Microsoft Access Database File, depois selecione OK.

  8. No Nome do arquivo de banco de dados, especifique o caminho e o nome do arquivo .mdb ao qual deseja se conectar e, em seguida, selecione OK.

    Adicionar arquivo de banco de dados de acesso à conexão

  9. Selecione Avançar na página Escolher a Conexão de Dados.

  10. Selecione Avançar na página Salvar cadeia de conexão no arquivo de Configuração de Aplicativo.

  11. Expanda o nó Tabelas na página Escolher Objetos do Banco de Dados.

  12. Selecione quais tabelas ou exibições deseja ter no conjunto de dados e selecione Concluir.

    O conjunto de dados é adicionado ao seu projeto, e as tabelas e exibições aparecem na janela de Fontes de Dados .

Exibir o código gerado

As ferramentas de dados são configuradas para gerar muito código automaticamente quando você executa determinadas operações no Designer de Formulários. Por exemplo, quando você arrasta e solta uma tabela no formulário, um DataGridView é adicionado e o código é criado para conectar os dados com o controle. Você pode exibir esse código no arquivo *.Designer.cs. O código gerado pode ser diferente dependendo da sua versão do Visual Studio.

Parabéns! Com uma pequena ajuda do Visual Studio, você criou uma experiência de edição baseada em formulário para uma tabela de dados do Access.

Próximas etapas

O conjunto de dados que você acabou de criar está disponível na janela de Fontes de Dados. Agora você pode executar qualquer uma das seguintes tarefas: