Guia de início rápido: use o .NET (C#) para consultar um banco de dados

  • Artigo

Aplica-se a:Banco de Dados SQL do Azure Azure SQLManaged InstanceAzure Synapse Analytics

Neste início rápido, você usará o código .NET e C# para se conectar a um banco de dados. Em seguida, você executará uma instrução Transact-SQL para consultar dados. Este início rápido é aplicável ao Windows, Linux e macOS e aproveita a plataforma .NET unificada.

Gorjeta

Este módulo gratuito do Learn mostra como desenvolver e configurar um aplicativo ASP.NET que consulta um banco de dados no Banco de Dados SQL do Azure

Pré-requisitos

Para concluir este guia de início rápido, necessita de:

Criar um novo projeto .NET

  1. Abra uma linha de comandos e crie uma pasta com o nome sqltest. Navegue até esta pasta e execute este comando.

    dotnet new console

    Este comando cria novos arquivos de projeto de aplicativo, incluindo um arquivo de código C# inicial (Programa.cs), um arquivo de configuração XML (sqltest.csproj) e binários necessários.

  2. No prompt de comando usado acima, execute este comando.

    dotnet add package Microsoft.Data.SqlClient

    Este comando adiciona o Microsoft.Data.SqlClient pacote ao projeto.

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

  1. Em um editor de texto, como o Visual Studio Code, abra Program.cs.

  2. Substitua o conteúdo pelo código a seguir e adicione os valores apropriados para seu servidor, banco de dados, nome de usuário e senha.

Nota

Para usar uma cadeia de conexão ADO.NET, substitua as 4 linhas no código que define o servidor, o banco de dados, o nome de usuário e a senha pela linha abaixo. Na cadeia de caracteres, defina seu nome de usuário e senha.

builder.ConnectionString="<your_ado_net_connection_string>";

using Microsoft.Data.SqlClient;

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");
                    
                    connection.Open();       

                    String sql = "SELECT name, collation_name FROM sys.databases";

                    using (SqlCommand command = new SqlCommand(sql, connection))
                    {
                        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.WriteLine("\nDone. Press enter.");
            Console.ReadLine(); 
        }
    }
}

Executar o código

  1. No prompt, execute os seguintes comandos.

    dotnet restore
dotnet run

  2. Verifique se as linhas são retornadas, sua saída pode incluir outros valores.

    Query data example:
=========================================

master    SQL_Latin1_General_CP1_CI_AS
tempdb    SQL_Latin1_General_CP1_CI_AS
WideWorldImporters    Latin1_General_100_CI_AS

Done. Press enter.

  3. Escolha Enter para fechar a janela do aplicativo.

Próximos passos