In der modernen Softwareentwicklung ist der effiziente Zugriff auf Datenbanken entscheidend für die Leistung und Skalierbarkeit von Anwendungen. Dapper, ein leichtgewichtiger Object-Relational Mapper (ORM) for .NET, bietet einen optimierten Ansatz für die Datenbankinteraktion. In diesem Artikel werden wir erkunden, wie man Dapper C# mit einer SQLite-Datenbankdatei verwendet und dabei seine Einfachheit und Effektivität anhand von Codebeispielen demonstriert. Zusätzlich werde ich die bemerkenswerte Bibliothek zur PDF-Erstellung namens IronPDF von Iron Software vorstellen.
Dapper ist ein objekt-relationales Mapping (ORM) Framework für die .NET-Plattform. Es ist ein einfacher Objektmapper, der es Ihnen ermöglicht, ein objektorientiertes Domänenmodell auf eine traditionelle relationale Datenbank abzubilden. Dapper ist bekannt für seine Geschwindigkeit und Leistung und wird oft als der "König der Micro ORM" bezeichnet. Es entspricht der Geschwindigkeit eines rohen ADO.NET Data Reader und erweitert das IDbConnection-Interface mit nützlichen Erweiterungsmethoden zum Abfragen von SQL-Datenbanken.
Dapper bietet asynchrone Erweiterungsmethoden, die ihre synchronen Gegenstücke nachbilden, was es Entwicklern ermöglicht, Datenbankabfragen asynchron auszuführen. Diese asynchronen Methoden sind ideal für I/O-gebundene Operationen wie Datenbankabfragen, bei denen der Hauptthread andere Aufgaben ausführen kann, während auf die Fertigstellung der Datenbankoperation gewartet wird.
QueryAsync: Führt eine SQL-Abfrage asynchron aus und gibt das Ergebnis als eine Sequenz von dynamischen Objekten oder stark typisierten Objekten zurück.QueryFirstOrDefaultAsync: Führt eine SQL-Abfrage asynchron aus und gibt das erste Ergebnis oder einen Standardwert zurück, wenn kein Ergebnis gefunden wird.ExecuteAsync: Führt einen SQL-Befehl asynchron aus (z.B. INSERT, UPDATE, DELETE) und gibt die Anzahl der betroffenen Zeilen zurück.Einrichten der Umgebung: Bevor Sie in Codebeispiele eintauchen, stellen Sie sicher, dass Sie die notwendigen Werkzeuge installiert haben:
Um das SQLite-Paket zu installieren, führen Sie den folgenden Befehl in Ihrem Projektverzeichnis aus:
dotnet add package Microsoft.Data.SqliteErstellen einer SQLite-Datenbank: Zu Demonstrationszwecken erstellen wir eine einfache SQLite-Datenbankdatei namens "example.db" mit einer "Users"-Tabelle, die Spalten für "Id", "Name" und "Email" enthält.
CREATE TABLE Users (
Id INTEGER PRIMARY KEY,
Name TEXT,
Email TEXT
);using Microsoft.Data.Sqlite;
using Dapper;Imports Microsoft.Data.Sqlite
Imports DapperStellen Sie eine Verbindung zur SQLite-Datenbank her:
string connectionString = "Data Source=example.db"; // SQLite database connection string
using (var connection = new SqliteConnection(connectionString))
{
connection.Open();
// Your Dapper queries will go here
}Dim connectionString As String = "Data Source=example.db" ' SQLite database connection string
Using connection = New SqliteConnection(connectionString)
connection.Open()
' Your Dapper queries will go here
End UsingFühren Sie eine Abfrage mit Dapper aus:
// 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 Property Id() As Integer
Public Property Name() As String
Public Property Email() As String
End Class
' Query to select all users
Private query As String = "SELECT * FROM Users" ' SQL query
Private users = connection.Query(Of User)(query).ToList()
' Display the results
For Each user In users
Console.WriteLine($"Id: {user.Id}, Name: {user.Name}, Email: {user.Email}")
Next userFügen Sie Daten mit Dapper in die Datenbank ein:
// 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
Dim newUser = New User With {
.Name = "John Doe",
.Email = "john@example.com"
}
' SQL query/stored procedure to insert a new user
Dim insertQuery As String = "INSERT INTO Users (Name, Email) VALUES (@Name, @Email)"
' Execute the query
connection.Execute(insertQuery, newUser)IronPDF ist eine C#-Bibliothek von Iron Software, die es Entwicklern ermöglicht, PDF-Dokumente programmatisch innerhalb von .NET-Anwendungen zu erstellen, zu bearbeiten und zu manipulieren. Es bietet Funktionen wie das Generieren von PDF-Dokumenten aus HTML, Bildern und anderen Formaten sowie das Hinzufügen von Text, Bildern und verschiedenen Elementen zu bestehenden PDF-Dateien. IronPDF zielt darauf ab, die Aufgaben der PDF-Erstellung und -Manipulation for .NET-Entwickler zu vereinfachen, indem es einen umfassenden Satz von Werkzeugen und APIs bereitstellt.
IronPDF bietet eine Reihe von Funktionen zur PDF-Erstellung und -Manipulation innerhalb von .NET-Anwendungen:
Erstellen Sie eine Konsolenanwendung in Visual Studio
Geben Sie den Projektnamen und den Speicherort an
Wählen Sie die .NET-Version aus
Installieren Sie die folgenden Pakete entweder aus dem Visual Studio-Paket-Manager oder über die Konsole
dotnet add package Microsoft.Data.Sqlite
dotnet add package Dapper --version 2.1.35
Verwenden Sie den folgenden Code, um ein PDF-Dokument zu erstellen:
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>";
}Imports Dapper ' Import Dapper for ORM functionalities
Imports IronPdf ' Import IronPDF for PDF generation
Imports Microsoft.Data.Sqlite ' Import Sqlite for database connection
' Define the connection string for SQLite database
Dim connectionString As String = "Data Source=ironPdf.db"
' Create a string to hold the content for the PDF document
Dim content As String = "<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 connection As 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
Dim sql As String = "CREATE TABLE IF NOT EXISTS Users (" & vbCrLf & " Id INTEGER PRIMARY KEY," & vbCrLf & " Name TEXT," & vbCrLf & " Email TEXT" & vbCrLf & ");"
connection.Execute(sql)
' Add Users to table using Dapper
content += "<h2>Add Users to table using Dapper</h2>"
content += AddUser(connection, New User With {.Name = "John Doe", .Email = "john@example.com"})
content += AddUser(connection, New User With {.Name = "Smith William", .Email = "Smith@example.com"})
content += AddUser(connection, New User With {.Name = "Rock Bill", .Email = "Rock@example.com"})
content += AddUser(connection, New User With {.Name = "Jack Sparrow", .Email = "Jack@example.com"})
content += AddUser(connection, New User With {.Name = "Tomus Tibe", .Email = "Tomus@example.com"})
' Retrieve and display users from database
content += "<h2>Get Users From table using Dapper</h2>"
Dim query As String = "SELECT * FROM Users"
Dim users = connection.Query(Of User)(query).ToList()
' Display each user detail retrieved from the database
For Each 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}")
Next
' Create PDF from the accumulated HTML content
Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf(content)
' Save the PDF to a file
pdf.SaveAs("dapper.pdf")
End Using
' Method to add user to the database and accumulate HTML content
Function AddUser(sqliteConnection As SqliteConnection, user As User) As String
Dim insertQuery As String = "INSERT INTO Users (Name, Email) VALUES (@Name, @Email)"
sqliteConnection.Execute(insertQuery, user)
Return $"<p>Name:{user.Name}, email: {user.Email}</p>"
End FunctionMicrosoft.Data.Sqlite, connection.Open() wird eine leere Datenbank erstellen.Users-Tabelle mit Dapper und führen Sie SQL-Abfragen zum Einfügen aus.ChromePdfRenderer und SaveAs.
Die Lizenzinformationen von IronPDF sind verfügbar, um die Einhaltung und Nutzung in Ihrem Projekt sicherzustellen.
Eine Testlizenz für Entwickler kann über die IronPDF-Testlizenzseite erworben werden.
Bitte ersetzen Sie den Schlüssel in der unten gezeigten appSettings.json-Datei:
{
"IronPdf.License.LicenseKey" : "The Key Goes Here"
}Dapper vereinfacht den Datenzugriff in .NET-Anwendungen, und in Kombination mit SQLite bietet es eine leichtgewichtige und effiziente Lösung zur Verwaltung von Datenbanken. Indem Sie die in diesem Artikel beschriebenen Schritte befolgen, können Sie Dapper nahtlos verwenden, um mit SQLite-Datenbanken zu interagieren, wodurch Sie robuste und skalierbare Anwendungen mit Leichtigkeit erstellen können. Zusammen mit IronPDF können Entwickler Fähigkeiten im Zusammenhang mit ORM-Datenbanken wie Dapper und PDF-Erstellungsbibliotheken wie IronPDF erwerben.
Jacob Mellor ist Chief Technology Officer bei Iron Software und ein visionärer Ingenieur, der Pionierarbeit in der C# PDF-Technologie leistet. Als der ursprüngliche Entwickler hinter der Kern-Codebasis von Iron Software hat er die Produktarchitektur des Unternehmens seit seiner Gründung geprägt und es zusammen mit CEO Cameron Rimington in ein Unternehmen mit mehr als 50 Mitarbeitern verwandelt, das die NASA, Tesla und globale Regierungsbehörden beliefert.
IronPDF ist ein Teil der IRONSUITE
10 .NET-API-Produkte für Ihre Bürodokumente
Wenn Ihr PDF wie HTML aussehen soll, schnell.
