Inicio rápido: uso de .NET y C# en Visual Studio para conectarse a una base de datos y consultarla

Se aplica a:Azure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics

En este inicio rápido se muestra cómo usar .NET y el código de C# en Visual Studio para consultar una base de datos de Azure SQL o Synapse SQL con instrucciones Transact-SQL.

Requisitos previos

Para completar este inicio rápido necesita instalar:

Creación de código para consultar la base de datos en Azure SQL Database

  1. En Visual Studio, cree un nuevo proyecto.

  2. En el cuadro de diálogo Nuevo proyecto, seleccione la App de consola C#.

  3. Escriba sqltest en el nombre del proyecto y, luego, seleccione Siguiente.

  4. Seleccione una opción (Soporte a largo plazo) Framework, como .NET 6.0, y luego seleccione Crear. Se crea el proyecto.

  5. Seleccione Proyecto>Administrar paquetes NuGet.

  6. En Administrador de paquetes NuGet, seleccione la pestaña Examinar y busque y seleccione Microsoft.Data.SqlClient.

  7. En la página Microsoft.Data.SqlClient, seleccione Instalar.

    • Si se le solicita, seleccione Aceptar para seguir con la instalación.
    • Si aparece la ventana Aceptación de la licencia, seleccione Acepto.
  8. Cuando se complete la instalación, puede cerrar el Administrador de paquetes NuGet.

  9. En el editor de código, reemplace el contenido de Program.cs por el código siguiente. Reemplace los valores de <your_server>, <your_username>, <your_password> y <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();
            }
        }
    }
    

Ejecución del código

  1. Para ejecutar la aplicación, seleccione Depurar>Iniciar depuración, o bien seleccione Iniciar en la barra de herramientas o presione F5.
  2. Compruebe que se devuelven los nombres de las bases de datos y sus intercalaciones y, después, cierre la ventana de la aplicación.

Pasos siguientes