Inicio rápido: Uso de .NET (C#) para consultar una base de datos

  • Artículo

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

En este tutorial de inicio rápido, usará código de C# y .NET para conectarse a una base de datos. Luego, ejecutará una instrucción Transact-SQL para consultar los datos. Este inicio rápido se aplica a Windows, Linux y macOS y aprovecha la plataforma unificada de .NET.

Sugerencia

Este módulo de aprendizaje gratuito le muestra cómo Desarrollar y configurar una aplicación ASP.NET que consulte una base de datos en Azure SQL Database

Requisitos previos

Para completar este inicio rápido necesita instalar:

Creación de un nuevo proyecto de .NET

  1. Abra un símbolo del sistema y cree una carpeta denominada sqltest. Vaya a esta carpeta y ejecute este comando.

    dotnet new console

    Con este comando se crean nuevos archivos de proyecto de aplicaciones, incluido un archivo de código de C# inicial (Program.cs), un archivo de configuración XML (sqltest.csproj) y los archivos binarios necesarios.

  2. En la línea de comandos utilizada anteriormente, ejecute este comando.

    dotnet add package Microsoft.Data.SqlClient

    Este comando agrega el paquete Microsoft.Data.SqlClient al proyecto.

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

  1. En un editor de texto como Visual Studio Code, abra Program.cs.

  2. Reemplace el contenido con el código siguiente y agregue los valores adecuados para el servidor, la base de datos, el nombre de usuario y la contraseña.

Nota:

Para usar una cadena de conexión ADO.NET, reemplace las 4 líneas del código donde se establece el servidor, la base de datos, el nombre de usuario y la contraseña por la línea que aparece a continuación. En la cadena, establezca el nombre de usuario y la contraseña.

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(); 
        }
    }
}

Ejecución del código

  1. En el símbolo del sistema, ejecute estos comandos.

    dotnet restore
dotnet run

  2. Compruebe que se devuelven las filas, la salida puede incluir otros 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. Elija ENTRAR para cerrar la ventana de la aplicación.

Pasos siguientes