Partilhar via


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 AzureInstâ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:

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 a Aplicação de Consola C#.

  3. Introduza sqltest como nome do projeto e, em seguida, selecione Avançar.

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

  5. Selecione projeto>Gerenciar pacotes NuGet.

  6. Em Gerenciador de Pacotes NuGet, selecione a guia Procurar e, em seguida, 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 Gerenciador de Pacotes NuGet.

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

  1. Para executar o aplicativo, selecione Depurar>Iniciar Depuraçãoou 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.