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

  • Artículo
  • Tiempo de lectura: 2 minutos

SE APLICA A: Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics

En este tutorial de inicio rápido, usará código de C# y .NET Core para conectarse a una base de datos. Luego, ejecutará una instrucción Transact-SQL para consultar los datos.

Sugerencia

El siguiente módulo de Microsoft Learn le ayuda gratis a aprender cómo desarrollar y configurar una aplicación ASP.NET que consulta una base de datos de Azure SQL Database

Requisitos previos

Para completar este inicio rápido necesita instalar:

Creación de un proyecto de .NET Core

  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 un editor de texto, abra sqltest.csproj y pegue el XML siguiente entre las etiquetas <Project>. Este XML agrega System.Data.SqlClient como dependencia.

    <ItemGroup>
    <PackageReference Include="System.Data.SqlClient" Version="4.6.0" />
</ItemGroup>

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

  1. En un editor de texto, 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 System;
using System.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");
                    
                    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.

    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