Início Rápido: Usar .NET e C# no Visual Studio para se conectar a um banco de dados e consultá-lo

Aplica-se a:Banco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse Analytics

Este guia de início rápido mostra como usar o .NET e o código C# no Visual Studio para consultar um banco de dados no SQL do Azure ou no SQL do Synapse com as instruções Transact-SQL.

Pré-requisitos

Para concluir este início rápido, você precisa de:

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 Aplicativo de Console C#.

  3. Insira sqltest para o nome do projeto e escolha Avançar.

  4. Selecione uma opção do Framework (Suporte de longo prazo), como o .NET 6.0 e escolha Criar. Quando um novo projeto é criado.

  5. Selecione Projeto>Gerenciar Pacotes do NuGet.

  6. Na Gerenciador de Pacotes NuGet, selecione a guia Procurar e pesquise 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 uma janela Aceitação da Licença for exibida, selecione Aceito.
  8. Quando a instalação for concluída, você poderá fechar Gerenciador de Pacotes NuGet.

  9. No editor de códigos, substitua o conteúdo de Program.cs pelo código a seguir. Substitua os valores para <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 ou Iniciar na barra de ferramentas ou pressione F5.
  2. Verifique se nomes e agrupamentos de bancos de dados são retornados e feche a janela do aplicativo.

Próximas etapas