Partilhar via


Liga-te a uma base de dados no Visual Studio

Os passos deste artigo mostram como se ligar a uma fonte de dados no IDE do Visual Studio. A fonte de dados pode ser uma base de dados local, um serviço de dados online ou uma base de dados aberta a partir de um .mdf ficheiro. Podes trabalhar diretamente com os teus dados no Visual Studio. Podes executar consultas, editar dados, criar e editar tabelas e outras propriedades de esquema, editar procedimentos e funções armazenadas, triggers, e assim por diante. Estas funções são independentes da linguagem de programação ou da versão .NET que estás a usar.

Se estiver a trabalhar com uma base de dados Access (.accdb ficheiro), veja Ligar a uma base de dados Access em aplicações .NET Framework.

Server Explorer e SQL Server Object Explorer

Pode abrir uma ligação a uma base de dados ou serviço, ou a uma base de dados LocalDB aberta a partir de um .mdf ficheiro, e visualizar e editar tabelas e linhas de dados, usando o Server Explorer ou o SQL Server Object Explorer. A funcionalidade destas janelas sobrepõe-se até certo ponto. As diferenças básicas são:

  • Explorador de Servidores

    Instalado por defeito no Visual Studio. Pode ser usado para testar ligações e visualizar bases de dados SQL Server, quaisquer outras bases de dados que tenham um fornecedor ADO.NET instalado, e alguns serviços Azure. Também mostra objetos de baixo nível, como contadores de desempenho do sistema, registos de eventos e filas de mensagens. Se uma fonte de dados não tiver fornecedor de ADO.NET, não aparecerá aqui, mas ainda podes usá-la a partir do Visual Studio ligando-a programaticamente.

  • SQL Server Object Explorer

    Instalado com SQL Server Data Tools e visível no menu Visualizar . Se não o vires lá, vai a Programas e Funcionalidades no Painel de Controlo, encontra Visual Studio e depois seleciona Alterar para reexecutar o instalador depois de selecionares a caixa de seleção para SQL Server Data Tools. Use o SQL Server Object Explorer para visualizar bases de dados SQL (se tiverem um fornecedor ADO.NET), criar novas bases de dados, modificar esquemas, criar procedimentos armazenados, recuperar strings de ligação, visualizar os dados e muito mais. Bases de dados SQL que não têm nenhum fornecedor de ADO.NET instalado não aparecem aqui, mas ainda podes ligar-te a elas programaticamente.

Adicionar uma ligação no Server Explorer

Para criar uma ligação à base de dados, clique no ícone Ligar à base de dados no Explorador de Servidores, ou clique com o botão direito no Explorador de Servidores no nó Ligações de Dados e selecione Adicionar Ligação. A partir daqui, pode abrir uma ligação a uma base de dados LocalDB aberta a partir de um .mdf ficheiro, ligar-se a uma base de dados noutro servidor, a um serviço SharePoint ou a um serviço Azure.

Captura de ecrã que mostra o ícone

Isto abre a caixa de diálogo Adicionar Ligação . Aqui, introduzimos o nome da instância SQL Server LocalDB, (localdb)\MSSqlLocalDBque normalmente é instalada com o Visual Studio.

Se não tiver acesso a outra base de dados e não vir o LocalDB instalado, pode instalar o LocalDB através do Visual Studio Installer, como parte da carga de armazenamento e processamento de dados , da carga de trabalho de ASP.NET e desenvolvimento web , ou como componente individual. Consulte Modificar o Visual Studio.

Captura de ecrã da caixa de diálogo Adicionar Nova Ligação.

No Visual Studio 2022 versão 17.8 e posteriores, o diálogo inclui duas novas opções (Encrypt e Trust Server Certificate) que entram na string de ligação e afetam as definições de segurança usadas para a sua ligação. Estas opções suportam as funcionalidades de segurança mais rigorosas do driver da base de dados Microsoft.Data.SqlClient 4.0. Ver Alterações no comportamento de encriptação e validação de certificados.

A prática de segurança recomendada é usar encriptação e instalar um certificado no servidor para isso. Veja Encriptação e validação de certificados. Para optar por não aderir a esta segurança reforçada, defina Encriptar como Opcional (Falso).

Se não definires o Encrypt como opcional com o Visual Studio 17.8 ou posterior, que usam a versão 4.0 do Microsoft.Data.SqlClient, então a encriptação passa a ser obrigatória. Isto representa uma mudança radical em relação ao comportamento das versões anteriores. Se não tiver um certificado válido ou não escolher Trust Server Certificate, recebe a seguinte mensagem de erro:

A criptografia foi habilitada nessa conexão, revise sua configuração de SSL e certificado para o SQL Server de destino ou habilite 'Certificado de servidor confiável' na caixa de diálogo de conexão.

Informações adicionais

Uma conexão foi estabelecida com êxito com o servidor, mas ocorreu um erro durante o processo de login. (fornecedor: SSL Provider, erro: 0 - A cadeia de certificados foi emitida por uma autoridade que não é confiável.) (Microsoft SQL Server)

Tipos de autenticação

Pode escolher entre vários tipos de autenticação que abrangem uma grande variedade de cenários. Para mais detalhes, veja Tipos de autenticação.

No Visual Studio 17.8 e posteriores, os nomes das opções de autenticação para ligações SQL foram atualizados para refletir a mudança de nome de Active Directory para Microsoft Entra.

Captura de ecrã que mostra tipos de autenticação para Visual Studio 17.8 e posteriores.

Abrir um ficheiro de base de dados MDF

O .mdf ficheiro significa Master Database File e é uma base de dados SQL empacotada num ficheiro. Estes ficheiros têm um .ldf (Ficheiro de Base de Dados de Registos) associado que contém os registos dessa base de dados. Pode criar novas bases de dados que são armazenadas em .mdf ficheiros adicionando um item de Base de Dados Baseada em Serviços ao seu projeto. Veja Criar uma base de dados e adicionar tabelas.

Se já tiver .mdf ficheiro no seu projeto, pode fazer duplo clique ou botão direito e escolher Abrir para o abrir no Explorador de Servidores.

Para abrir um .mdf ficheiro que não está no seu projeto no Explorador de Servidores do Visual Studio, siga estes passos:

  1. Na caixa de diálogo Adicionar ligação, em Fonte de Dados, escolha Ficheiro de Base de Dados Microsoft SQL Server (SqlClient).

  2. Use o botão Navegar para encontrar e selecionar o seu ficheiro mestre da base de dados (.mdf ficheiro), ou introduza o caminho na caixa de nome do ficheiro Base de Dados .

    Captura de ecrã que mostra a caixa de diálogo Adicionar Ligação, ligando-se a um ficheiro de base de dados SQL.

  3. Escolha o método de autenticação.

  4. Teste a ligação e, se for bem-sucedida, escolha OK. Um nó para a base de dados abre-se no Server Explorer.

Muda de fornecedor

Se a fonte de dados não for o que pretende, clique no botão Alterar para escolher uma nova fonte de dados ou um novo fornecedor de dados ADO.NET. O novo fornecedor pode pedir as suas credenciais, dependendo de como configurou.

Observação

Se estiver a usar o Visual Studio 2022 para se ligar a fornecedores de dados OLEDB ou ODBC, terá de 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 a bancos de dados OLEDB ou ODBC usando provedores de dados de 32 bits. Isso inclui o provedor de dados OLEDB de 32 bits do Microsoft Access, bem como outros provedores de 32 bits de terceiros.

Se precisar de manter aplicações de 32 bits que se conectem a OLEDB ou ODBC, ainda poderá construir e executar a aplicação com o Visual Studio 2022. No entanto, se precisar de usar alguma das ferramentas de dados do Visual Studio como o Server Explorer, o Data Source Wizard ou o DataSet Designer, terá de usar uma versão anterior do Visual Studio que ainda seja um processo de 32 bits. A última versão do Visual Studio que era um processo de 32 bits foi o Visual Studio 2019.

Se planeia converter o projeto para um processo de 64 bits, terá de atualizar as ligações de dados OLEDB e ODBC para usar fornecedores de dados de 64 bits.

Se a sua aplicação utiliza bases de dados Microsoft Access e pode converter o projeto para 64 bits, recomenda-se que utilize o Motor de Base de Dados Microsoft Access de 64 bits, também chamado Access Connectivity Engine (ACE). Por favor, consulte o OLE DB Provider for Jet e o driver ODBC são apenas versões de 32 bits para mais informações.

Se estiver a usar um fornecedor de dados de terceiros, recomendamos que se ligue ao seu fornecedor para ver se oferece um fornecedor de 64 bits antes de converter o projeto para 64 bits.

Captura de ecrã a mostrar como mudar o ADO.NET fornecedor de dados.

Testar a ligação

Depois de escolher a fonte de dados, clique em Testar Ligação. Se não tiver sucesso, terá de fazer uma solução de problemas com base na documentação do fornecedor.

Captura de ecrã a mostrar a caixa de mensagem de sucesso da ligação de teste.

Se o teste for bem-sucedido, está pronto para criar uma fonte de dados, que é um termo do Visual Studio que realmente significa um modelo de dados baseado na base de dados ou serviço subjacente.

Ligue-se usando o SQL Server Object Explorer

A experiência pode ser mais fácil se usar o SQL Server Object Explorer, que lhe dá um diálogo que ajuda mais a encontrar bases de dados disponíveis localmente, na rede local e nas suas subscrições do Azure, além de fornecer um histórico das escolhas usadas recentemente.

Para aceder ao diálogo de ligação a partir do SQL Server Object Explorer, clique no botão da barra de ferramentas Adicionar SQL Server.

Captura de ecrã do botão Adicionar SQL Server no SQL Server Object Explorer

Aparece o diálogo de conexão. Escolha o seu servidor local, de rede ou Azure SQL Server, selecione uma base de dados, forneça credenciais e escolha Conectar.

Captura de ecrã do diálogo Connect do SQL Server Object Explorer.

Se precisares de definir outras definições na tua string de ligação, podes usar o link Avançado , que abre todas as definições. Por exemplo, para se ligar a uma base de dados LocalDB baseada num ficheiro MDF, escolha Avançado e depois defina a propriedade AnexarDbFicheiro.

Captura de ecrã a mostrar definições avançadas.

Depois de terminar de configurar a ligação, o servidor e a base de dados são mostrados na janela do Explorador de Objetos do SQL Server.

Captura de ecrã a mostrar a mensagem Ligado com sucesso.

A partir daí, pode navegar pela base de dados, escrever e executar consultas, editar dados, stored procedures e funções, e executar outras ações diretamente no Visual Studio.

Próximos passos

Se estiver a usar o .NET Framework (não .NET Core ou .NET 5 ou versões posteriores), e Windows Forms ou WPF, pode usar a janela de Fontes de Dados , por exemplo, para configurar a ligação de dados para controlos em Windows Forms e aplicações WPF, veja Adicionar novas fontes de dados. Estas ferramentas foram concebidas para lhe permitir criar rapidamente aplicações Windows que precisam de permitir aos utilizadores inserir, mostrar e manipular dados.

Se estiver a usar .NET 5 ou posterior, .NET Core ou ASP.NET Core, pode ligar a sua aplicação à base de dados usando Connected Services. Usando Connected Services, pode facilmente usar uma base de dados local de desenvolvimento, alojada no SQL LocalDB, SQL Server a correr num contentor ou uma instância local do SQL Server, e depois fazer a transição para o Azure SQL Database quando estiver pronto para implementar na cloud. Para .NET 5 ou posteriores, .NET Core e ASP.NET Core, deve considerar usar Entity Framework Core como estrutura de base de dados.