Dapper C# (Cómo Funciona para Desarrolladores)

¿Qué es Dapper?

Dapper es un marco de mapeo objeto-relacional (ORM) para la plataforma .NET. Es un mapeador de objetos sencillo que te permite mapear un modelo de dominio orientado a objetos a una base de datos relacional tradicional. Dapper es conocido por su velocidad y rendimiento, a menudo llamado el "Rey del Micro ORM". Igual a la velocidad de un lector de datos ADO.NET bruto y mejora la interfaz IDbConnection con métodos de extensión útiles para consultar bases de datos SQL.

dotnet add package Microsoft.Data.Sqlite

dotnet add package Microsoft.Data.Sqlite

CREATE TABLE Users (
    Id INTEGER PRIMARY KEY,
    Name TEXT,
    Email TEXT
);

Uso de Dapper con SQLite

1. Primero, asegúrate de tener los espacios de nombres necesarios importados:

using Microsoft.Data.Sqlite;
using Dapper;

using Microsoft.Data.Sqlite;
using Dapper;

2. Establece una conexión a la base de datos SQLite:

   string connectionString = "Data Source=example.db"; // SQLite database connection string
   using (var connection = new SqliteConnection(connectionString))
   {
       connection.Open();
       // Your Dapper queries will go here
   }

   string connectionString = "Data Source=example.db"; // SQLite database connection string
   using (var connection = new SqliteConnection(connectionString))
   {
       connection.Open();
       // Your Dapper queries will go here
   }

   $vbLabelText   $csharpLabel

3. Ejecuta una consulta con Dapper:

   // Define a class to represent the structure of a user
   public class User
   {
       public int Id { get; set; }
       public string Name { get; set; }
       public string Email { get; set; }
   }
   
   // Query to select all users
   string query = "SELECT * FROM Users"; // SQL query
   var users = connection.Query<User>(query).ToList();
   
   // Display the results
   foreach (var user in users)
   {
       Console.WriteLine($"Id: {user.Id}, Name: {user.Name}, Email: {user.Email}");
   }

   // Define a class to represent the structure of a user
   public class User
   {
       public int Id { get; set; }
       public string Name { get; set; }
       public string Email { get; set; }
   }
   
   // Query to select all users
   string query = "SELECT * FROM Users"; // SQL query
   var users = connection.Query<User>(query).ToList();
   
   // Display the results
   foreach (var user in users)
   {
       Console.WriteLine($"Id: {user.Id}, Name: {user.Name}, Email: {user.Email}");
   }

   $vbLabelText   $csharpLabel

4. Inserta datos en la base de datos usando Dapper:

   // Define a new user 
   var newUser = new User { Name = "John Doe", Email = "john@example.com" };
   
   // SQL query/stored procedure to insert a new user
   string insertQuery = "INSERT INTO Users (Name, Email) VALUES (@Name, @Email)";
   
   // Execute the query
   connection.Execute(insertQuery, newUser);

   // Define a new user 
   var newUser = new User { Name = "John Doe", Email = "john@example.com" };
   
   // SQL query/stored procedure to insert a new user
   string insertQuery = "INSERT INTO Users (Name, Email) VALUES (@Name, @Email)";
   
   // Execute the query
   connection.Execute(insertQuery, newUser);

   $vbLabelText   $csharpLabel

Presentando IronPDF

IronPDF es una biblioteca C# de Iron Software que permite a los desarrolladores crear, editar y manipular documentos PDF de manera programática dentro de aplicaciones .NET. Proporciona características como la generación de documentos PDF desde HTML, imágenes y otros formatos, así como la adición de texto, imágenes y varios elementos a archivos PDF existentes. IronPDF tiene como objetivo simplificar las tareas de generación y manipulación de PDF para los desarrolladores de .NET proporcionando un conjunto completo de herramientas y APIs.

IronPDF ofrece una variedad de características para la generación y manipulación de PDF dentro de aplicaciones .NET:

1. Conversión de HTML a PDF: Convierta contenido HTML, incluidos estilos CSS, en documentos PDF.
2. Conversión de imagen a PDF: Convierta imágenes (como JPEG, PNG, BMP) a documentos PDF.
3. Conversión de texto a PDF: Convierta texto plano o texto con formato (RTF) a documentos PDF.
4. Generación de PDF: Cree documentos PDF desde cero de manera programática.
5. Edición de PDF: Edite documentos PDF existentes agregando o modificando texto, imágenes y otros elementos.
6. Combinación y división de PDF: Combine múltiples documentos PDF en un solo documento, o divida un documento PDF en múltiples archivos.
7. Seguridad de PDF: Aplique protección con contraseña y cifrado a los documentos PDF para restringir el acceso y proteger información sensible.
8. Relleno de formularios PDF: Completa formularios PDF con datos de manera programática.
9. Impresión de PDF: Imprime documentos PDF directamente desde tu aplicación .NET.
10. Configuración de conversión de PDF: Personaliza varias configuraciones como el tamaño de página, orientación, márgenes, compresión y más durante la generación de PDF.
11. Extracción de texto de PDF: Extrae contenido de texto de documentos PDF para su posterior procesamiento o análisis.
12. Metadatos de PDF: Establezca metadatos (autor, título, asunto, palabras clave) para documentos PDF.

Generación de documentos PDF con IronPDF y Dapper

Crea una aplicación de consola en Visual Studio

Proporcione el nombre y la ubicación del proyecto

Seleccione versión de .NET

Instale los siguientes paquetes ya sea desde el Administrador de Paquetes de Visual Studio o la consola

dotnet add package Microsoft.Data.Sqlite

dotnet add package Microsoft.Data.Sqlite

dotnet add package Dapper --version 2.1.35

dotnet add package Dapper --version 2.1.35

dotnet add package IronPdf --version 2024.4.2

dotnet add package IronPdf --version 2024.4.2

Utiliza el siguiente código para generar un documento PDF:

using Dapper; // Import Dapper for ORM functionalities
using IronPdf; // Import IronPDF for PDF generation
using Microsoft.Data.Sqlite; // Import Sqlite for database connection

// Define the connection string for SQLite database
string connectionString = "Data Source=ironPdf.db";

// Create a string to hold the content for the PDF document
var content = "<h1>Demonstrate IronPDF with Dapper</h1>";

// Add HTML content
content += "<h2>Create a new database using Microsoft.Data.Sqlite</h2>";
content += "<p>new SqliteConnection(connectionString) and connection.Open()</p>";

// Open the database connection
using (var connection = new SqliteConnection(connectionString))
{
    connection.Open();

    // Create a Users Table using Dapper
    content += "<h2>Create a Users Table using Dapper and SQL insert query</h2>";
    content += "<p>CREATE TABLE IF NOT EXISTS Users</p>";

    // SQL statement to create a Users table
    string sql = "CREATE TABLE IF NOT EXISTS Users (\n    Id INTEGER PRIMARY KEY,\n    Name TEXT,\n    Email TEXT\n);";
    connection.Execute(sql);

    // Add Users to table using Dapper
    content += "<h2>Add Users to table using Dapper</h2>";
    content += AddUser(connection, new User { Name = "John Doe", Email = "john@example.com" });
    content += AddUser(connection, new User { Name = "Smith William", Email = "Smith@example.com" });
    content += AddUser(connection, new User { Name = "Rock Bill", Email = "Rock@example.com" });
    content += AddUser(connection, new User { Name = "Jack Sparrow", Email = "Jack@example.com" });
    content += AddUser(connection, new User { Name = "Tomus Tibe", Email = "Tomus@example.com" });

    // Retrieve and display users from database
    content += "<h2>Get Users From table using Dapper</h2>";
    string query = "SELECT * FROM Users";
    var users = connection.Query<User>(query).ToList();

    // Display each user detail retrieved from the database
    foreach (var user in users)
    {
        content += $"<p>Id:{user.Id}, Name:{user.Name}, email: {user.Email}</p>";
        Console.WriteLine($"{user.Id}. User Name:{user.Name}, Email:{user.Email}");
    }

    // Create PDF from the accumulated HTML content
    var renderer = new ChromePdfRenderer();
    var pdf = renderer.RenderHtmlAsPdf(content);

    // Save the PDF to a file
    pdf.SaveAs("dapper.pdf");
}

// Method to add user to the database and accumulate HTML content
string AddUser(SqliteConnection sqliteConnection, User user)
{
    string insertQuery = "INSERT INTO Users (Name, Email) VALUES (@Name, @Email)";
    sqliteConnection.Execute(insertQuery, user);
    return $"<p>Name:{user.Name}, email: {user.Email}</p>"; 
}

using Dapper; // Import Dapper for ORM functionalities
using IronPdf; // Import IronPDF for PDF generation
using Microsoft.Data.Sqlite; // Import Sqlite for database connection

// Define the connection string for SQLite database
string connectionString = "Data Source=ironPdf.db";

// Create a string to hold the content for the PDF document
var content = "<h1>Demonstrate IronPDF with Dapper</h1>";

// Add HTML content
content += "<h2>Create a new database using Microsoft.Data.Sqlite</h2>";
content += "<p>new SqliteConnection(connectionString) and connection.Open()</p>";

// Open the database connection
using (var connection = new SqliteConnection(connectionString))
{
    connection.Open();

    // Create a Users Table using Dapper
    content += "<h2>Create a Users Table using Dapper and SQL insert query</h2>";
    content += "<p>CREATE TABLE IF NOT EXISTS Users</p>";

    // SQL statement to create a Users table
    string sql = "CREATE TABLE IF NOT EXISTS Users (\n    Id INTEGER PRIMARY KEY,\n    Name TEXT,\n    Email TEXT\n);";
    connection.Execute(sql);

    // Add Users to table using Dapper
    content += "<h2>Add Users to table using Dapper</h2>";
    content += AddUser(connection, new User { Name = "John Doe", Email = "john@example.com" });
    content += AddUser(connection, new User { Name = "Smith William", Email = "Smith@example.com" });
    content += AddUser(connection, new User { Name = "Rock Bill", Email = "Rock@example.com" });
    content += AddUser(connection, new User { Name = "Jack Sparrow", Email = "Jack@example.com" });
    content += AddUser(connection, new User { Name = "Tomus Tibe", Email = "Tomus@example.com" });

    // Retrieve and display users from database
    content += "<h2>Get Users From table using Dapper</h2>";
    string query = "SELECT * FROM Users";
    var users = connection.Query<User>(query).ToList();

    // Display each user detail retrieved from the database
    foreach (var user in users)
    {
        content += $"<p>Id:{user.Id}, Name:{user.Name}, email: {user.Email}</p>";
        Console.WriteLine($"{user.Id}. User Name:{user.Name}, Email:{user.Email}");
    }

    // Create PDF from the accumulated HTML content
    var renderer = new ChromePdfRenderer();
    var pdf = renderer.RenderHtmlAsPdf(content);

    // Save the PDF to a file
    pdf.SaveAs("dapper.pdf");
}

// Method to add user to the database and accumulate HTML content
string AddUser(SqliteConnection sqliteConnection, User user)
{
    string insertQuery = "INSERT INTO Users (Name, Email) VALUES (@Name, @Email)";
    sqliteConnection.Execute(insertQuery, user);
    return $"<p>Name:{user.Name}, email: {user.Email}</p>"; 
}

Licencia (prueba disponible para IronPDF)

La información de licencias de IronPDF está disponible para garantizar el cumplimiento y uso dentro de tu proyecto.

Se puede obtener una licencia de prueba para desarrolladores a través de la página de licencia de prueba de IronPDF.

Por favor, reemplaza la clave en el archivo appSettings.json mostrado a continuación:

{
  "IronPdf.License.LicenseKey" : "The Key Goes Here"
}

Conclusión

Dapper simplifica el acceso a datos en aplicaciones .NET, y cuando se combina con SQLite, proporciona una solución ligera y eficiente para gestionar bases de datos. Siguiendo los pasos descritos en este artículo, puedes aprovechar Dapper para interactuar con bases de datos SQLite sin problemas, lo que te permite construir aplicaciones robustas y escalables con facilidad. Junto con IronPDF, los desarrolladores pueden adquirir habilidades relacionadas con bases de datos ORM como Dapper y bibliotecas de generación de PDF como IronPDF.