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 Database Azure SQL Managed Instance Azure 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:
Una cuenta de Azure con una suscripción activa. Cree una cuenta gratuita.
Visual Studio 2022 Community, Professional o Enterprise.
Base de datos en la que puede ejecutar una consulta.
Puede utilizar uno de estos inicios rápidos para crear y configurar una base de datos:
Acción SQL Database Instancia administrada de SQL SQL Server en máquina virtual de Azure Azure Synapse Analytics Crear Portal Portal Portal Portal CLI CLI PowerShell PowerShell PowerShell PowerShell Plantilla de implementación Plantilla de implementación Plantilla de implementación Plantilla de implementación Configuración Regla de firewall de IP en el nivel de servidor Conectividad desde una máquina virtual Configuración de conectividad Conectividad desde un entorno local Conexión a una instancia de SQL Server Obtención de información sobre la conexión SQL de Azure SQL de Azure VM con SQL Synapse SQL
Creación de código para consultar la base de datos en Azure SQL Database
En Visual Studio, cree un nuevo proyecto.
En el cuadro de diálogo Nuevo proyecto, seleccione la App de consola C#.
Escriba sqltest en el nombre del proyecto y, luego, seleccione Siguiente.
Seleccione una opción (Soporte a largo plazo) Framework, como .NET 6.0, y luego seleccione Crear. El proyecto nuevo se crea.
Seleccione Proyecto>Administrar paquetes NuGet.
En Administrador de paquetes NuGet, seleccione la pestaña Examinar y busque y seleccione Microsoft.Data.SqlClient.
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.
Cuando se complete la instalación, puede cerrar el Administrador de paquetes NuGet.
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
- Para ejecutar la aplicación, seleccione Depurar>Iniciar depuración, o bien seleccione Iniciar en la barra de herramientas o presione F5.
- 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
- Aprenda a conectar y consultar una base de datos en Azure SQL Database utilizando .NET desde la línea de comandos en Windows/Linux/macOS.
- Aprenda sobre Introducción a .NET en Windows/Linux/macOS mediante VS Code.
- Obtenga más información sobre el desarrollo con .NET y SQL.
- Aprenda a Diseñar su primera base de datos en Azure SQL Database mediante SSMS.
- Para más información acerca de. NET, consulte la Documentación de .NET.
- Ejemplo de lógica de reintento: Conexión resistente a Azure SQL con ADO.NET.