Guia de início rápido: use .NET e C# no Visual Studio para se conectar e consultar um banco de dados

Aplica-se a:Banco de Dados SQL do Azure Azure SQLManaged InstanceAzure 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, necessita de:

• Uma conta do Azure com uma subscrição ativa. Crie uma conta gratuitamente.

• Visual Studio 2022 Community, Professional ou Enterprise edition.

• 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	Base de Dados SQL	Instância Gerida do SQL	SQL Server numa 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 local	Conectar-se a uma instância do SQL Server
  Obter informações da ligação	SQL do Azure	SQL do Azure	SQL VM	Sinapse SQL

Criar código para consultar o banco de dados no Banco de Dados SQL do Azure

1. No Visual Studio, crie um novo projeto.

2. Na caixa de diálogo Novo Projeto, selecione o Aplicativo de Console C#.

3. Digite sqltest para o nome do projeto e selecione Avançar.

4. Selecione uma opção (Suporte de longo prazo) Framework, como .NET 6.0 e, em seguida, selecione Criar. O novo projeto é criado.

5. Selecione Project>Manage NuGet Packages.

6. No Gerenciador de Pacotes NuGet, selecione a guia Procurar , procure e selecione Microsoft.Data.SqlClient.

7. 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.

8. Quando a instalação for concluída, você poderá fechar o Gerenciador de Pacotes NuGet.

9. No editor de códigos, substitua o conteúdo .cs programa pelo código a seguir. Substitua os valores de <your_server>, , <your_username><your_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 = "<your_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();
           }
       }
   }
   

Executar o código

1. Para executar o aplicativo, selecione Depurar Iniciar Depuração>, selecione Iniciar na barra de ferramentas ou pressione F5.
2. Verifique se os nomes e agrupamentos do banco de dados são retornados e feche a janela do aplicativo.

Próximos passos

• Saiba como conectar e consultar um banco de dados no Banco de Dados SQL do Azure usando o .NET na linha de comando no Windows/Linux/macOS.
• Saiba mais sobre Introdução ao .NET no Windows/Linux/macOS usando o VS Code.
• Saiba mais sobre como desenvolver com .NET e SQL.
• Saiba como criar seu primeiro banco de dados no Banco de Dados SQL do Azure usando o SSMS.
• Para obter mais informações sobre o .NET, veja a Documentação .NET.
• Exemplo de lógica de repetição: conecte-se de forma resiliente ao SQL do Azure com ADO.NET.