Guia de início rápido: conectar-se e consultar um banco de dados com .NET e C# no Visual Studio
Aplica-se a:Banco de Dados SQL do Azure
Instância Gerenciada SQL do Azure
do Azure Synapse Analytics
Este guia de início rápido mostra como usar o código .NET e C# no Visual Studio para consultar um banco de dados no Azure SQL ou Synapse SQL com instruções Transact-SQL.
Pré-requisitos
Para concluir este guia de início rápido, você precisa:
Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
Visual Studio 2022 Edição Community, Professional ou Enterprise.
Um banco de dados onde você pode executar uma consulta.
Você pode usar um destes guias de início rápido para criar e configurar um banco de dados:
Ação Banco de dados SQL Instância Gerida do SQL SQL Server na VM do Azure Azure Synapse Analytics Criar Portal Portal Portal Portal CLI CLI PowerShell PowerShell PowerShell PowerShell Modelo de implantação Modelo de implantação Modelo de implantação Modelo de implantação Configurar Regra de firewall IP no nível do servidor Conectividade de uma VM Configurações de conectividade Conectividade a partir de instalações no local conectar-se a uma instância do SQL Server Obter informações de conexão SQL do Azure SQL do Azure SQL VM Synapse SQL
Criar código para consultar o banco de dados no Banco de Dados SQL do Azure
No Visual Studio, crie um novo projeto.
Na caixa de diálogo Novo Projeto, selecione a Aplicação de Consola C#.
Introduza sqltest como nome do projeto e, em seguida, selecione Avançar.
Selecione uma opção (Suporte de longo prazo) Framework, como .NET 8.0e, em seguida, selecione Criar. O novo projeto é criado.
Selecione projeto>Gerenciar pacotes NuGet.
Em Gerenciador de Pacotes NuGet, selecione a guia Procurar e, em seguida, procure e selecione Microsoft.Data.SqlClient.
Na página Microsoft.Data.SqlClient, selecione Instalar.
- Se solicitado, selecione OK para continuar com a instalação.
- Se aparecer uma janela de Aceitação de Licença , selecione Aceito.
Quando a instalação for concluída, você poderá fechar Gerenciador de Pacotes NuGet.
No editor de códigos, substitua o conteúdo Program.cs pelo código a seguir. Substitua os valores de
<your_server>
,<your_username>
,<password>
e<your_database>
.using System; using Microsoft.Data.SqlClient; using System.Text; namespace sqltest { class Program { static void Main(string[] args) { try { SqlConnectionStringBuilder builder = new SqlConnectionStringBuilder(); builder.DataSource = "<your_server>.database.windows.net"; builder.UserID = "<your_username>"; builder.Password = "<password>"; builder.InitialCatalog = "<your_database>"; using (SqlConnection connection = new SqlConnection(builder.ConnectionString)) { Console.WriteLine("\nQuery data example:"); Console.WriteLine("=========================================\n"); String sql = "SELECT name, collation_name FROM sys.databases"; using (SqlCommand command = new SqlCommand(sql, connection)) { connection.Open(); using (SqlDataReader reader = command.ExecuteReader()) { while (reader.Read()) { Console.WriteLine("{0} {1}", reader.GetString(0), reader.GetString(1)); } } } } } catch (SqlException e) { Console.WriteLine(e.ToString()); } Console.ReadLine(); } } }
Execute o código
- Para executar o aplicativo, selecione Depurar>Iniciar Depuraçãoou selecione Iniciar na barra de ferramentas ou pressione F5.
- Verifique se os nomes e agrupamentos do banco de dados são retornados e feche a janela do aplicativo.
Conteúdo relacionado
- Guia de início rápido: use o .NET (C#) para consultar um banco de dados
- Introdução ao .NET no Windows/Linux/macOS usando o VS Code
- Desenvolvimento com .NET e SQL
- Tutorial: Criar um banco de dados relacional no Banco de Dados SQL do Azure
- Documentação do .NET
- Conecte-se de forma resiliente ao SQL do Azure com o ADO.NET