¿Cómo usar Dapper en C#?

Dapper es una pequeña librería de mapeo de objetos para .NET que permite realizar consultas rápidas a la base de datos de una manera sencilla y eficiente. Utilizando Dapper, los desarrolladores pueden mapear resultados de consultas SQL a objetos C# de forma automática, evitando la necesidad de escribir código tedioso para la asignación manual de datos.

Para comenzar a utilizar Dapper en tu proyecto de C#, simplemente instala el paquete NuGet correspondiente y comienza a escribir consultas SQL de manera más fácil y legible. ¡Dapper facilita la interacción con la base de datos en tus aplicaciones de C#!

Dapper es una microORM (Object Relational Mapping) de código abierto para .NET que se utiliza para mapear resultados de consultas SQL a objetos .NET en C#. Es una herramienta muy útil y fácil de usar que optimiza el rendimiento de acceso a una base de datos y evita la necesidad de escribir mucho código repetitivo.

Instalación de Dapper

El primer paso para usar Dapper en tu proyecto de C# es instalar el paquete NuGet de Dapper. Puedes hacer esto desde el administrador de paquetes de Visual Studio o utilizando la línea de comandos de NuGet con el siguiente comando:

Install-Package Dapper

Una vez instalado Dapper en tu proyecto, puedes comenzar a utilizarlo importando el espacio de nombres Dapper en tus archivos de código C#:

using Dapper;

Configuración de la conexión a la base de datos

Antes de comenzar a usar Dapper, debes configurar la conexión a tu base de datos. Puedes hacer esto en tu archivo de configuración de la aplicación o proporcionando la cadena de conexión directamente en tu código. Aquí hay un ejemplo de cómo configurar la conexión a una base de datos SQL Server:

string connectionString = "Data Source=nombre_servidor;Initial Catalog=nombre_base_datos;User ID=usuario;Password=contraseña;";

Una vez que tienes la cadena de conexión configurada, puedes establecer la conexión a la base de datos utilizando la clase SqlConnection:

using (SqlConnection connection = new SqlConnection(connectionString))
{
    // Tu código utilizando Dapper
}

Ejecutando consultas SQL con Dapper

Una de las principales características de Dapper es su capacidad para ejecutar consultas SQL y mapear los resultados a objetos .NET de forma rápida y sencilla. Aquí hay algunos ejemplos de cómo ejecutar consultas SQL utilizando Dapper:

Consulta simple

Si deseas ejecutar una consulta SQL simple que no requiere parámetros, puedes utilizar el método Query de Dapper:

string query = "SELECT * FROM tabla";
IEnumerable<T> results = connection.Query<T>(query);

En este ejemplo, reemplaza «tabla» con el nombre de la tabla de tu base de datos y «T» con el tipo de objeto C# al que deseas mapear los resultados.

Consulta con parámetros

Si deseas ejecutar una consulta SQL que requiere parámetros, puedes utilizar el método Query de Dapper pasando los parámetros como un objeto anónimo:

string query = "SELECT * FROM tabla WHERE columna = @valor";
IEnumerable<T> results = connection.Query<T>(query, new { valor = "mi_valor" });

En este ejemplo, reemplaza «tabla» con el nombre de la tabla de tu base de datos, «columna» con el nombre de la columna que deseas filtrar y «valor» con el valor del filtro.

Insertar, actualizar y eliminar registros con Dapper

Además de ejecutar consultas SQL, Dapper también facilita la inserción, actualización y eliminación de registros en una base de datos. Aquí hay algunos ejemplos de cómo realizar estas operaciones utilizando Dapper:

Insertar un registro

string query = "INSERT INTO tabla (columna1, columna2) VALUES (@valor1, @valor2)";
int rowsAffected = connection.Execute(query, new { valor1 = "mi_valor1", valor2 = "mi_valor2" });

En este ejemplo, reemplaza «tabla» con el nombre de la tabla de tu base de datos, «columna1» y «columna2» con los nombres de las columnas en las que deseas insertar valores, y «valor1» y «valor2» con los valores que deseas insertar.

Actualizar un registro

string query = "UPDATE tabla SET columna = @nuevoValor WHERE id = @id";
int rowsAffected = connection.Execute(query, new { nuevoValor = "mi_nuevo_valor", id = 1 });

En este ejemplo, reemplaza «tabla» con el nombre de la tabla de tu base de datos, «columna» con el nombre de la columna que deseas actualizar, «nuevoValor» con el nuevo valor que deseas asignar y «id» con el identificador del registro que deseas actualizar.

Eliminar un registro

string query = "DELETE FROM tabla WHERE id = @id";
int rowsAffected = connection.Execute(query, new { id = 1 });

En este ejemplo, reemplaza «tabla» con el nombre de la tabla de tu base de datos y «id» con el identificador del registro que deseas eliminar.

Dapper es una herramienta muy útil y fácil de usar para trabajar con bases de datos en proyectos de C#. Permite ejecutar consultas SQL y mapear los resultados a objetos .NET de manera rápida y sencilla, además de facilitar la inserción, actualización y eliminación de registros en una base de datos. Si estás buscando una manera eficiente y simple de acceder a una base de datos desde tu aplicación C#, definitivamente deberías considerar utilizar Dapper.

¡Espero que este artículo te haya sido útil para aprender cómo usar Dapper en C#! Ahora puedes aprovechar al máximo esta herramienta en tus proyectos.

Dapper es una herramienta eficiente y sencilla de usar para acceder a bases de datos en aplicaciones C#. Su facilidad de implementación y su alto rendimiento la convierten en una excelente opción para trabajar con consultas SQL de manera más limpia y rápida. ¡Aprovecha todas las ventajas de Dapper en tus proyectos de desarrollo!