Dapper C# (Funktionsweise für Entwickler)
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) für .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.
Was ist Dapper?
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.
Hauptmerkmale von Dapper
- Leistung: Dapper ist für seine hervorragende Leistung bekannt, die auf sein leichtes Design und sein effizientes Objektmapping zurückzuführen ist.
- Einfachheit: Die Dapper-API ist minimalistisch und intuitiv gestaltet, sodass Entwickler sie leicht verstehen und effektiv nutzen können.
- Unterstützung für rohes SQL: Dapper ermöglicht es Entwicklern, rohe SQL-Abfragen zu schreiben und bietet so die volle Kontrolle über die Datenbankinteraktionen.
- Objektmapping: Dapper ordnet Abfrageergebnisse direkt C#-Objekten zu, wodurch Boilerplate-Code reduziert und die Lesbarkeit des Codes verbessert wird.
- Parametrisierte Abfragen: Dapper unterstützt parametrisierte Abfragen, wodurch Schutz vor SQL-Injection-Angriffen geboten und die Leistung verbessert wird.
- Multi-Mapping: Dapper verarbeitet nahtlos Eins-zu-Viele- und Viele-zu-Viele-Beziehungen, sodass mehrere Abfragen effizient ausgeführt werden können und die komplexe Datenabfrage vereinfacht wird.
Asynchroner Datenzugriff mit Dapper
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.
Wichtige asynchrone Methoden in Dapper
QueryAsync: Führt eine SQL-Abfrage asynchron aus und gibt das Ergebnis als Sequenz dynamischer Objekte oder stark typisierter Objekte zurück.QueryFirstOrDefaultAsync: Führt eine SQL-Abfrage asynchron aus und gibt das erste Ergebnis oder einen Standardwert zurück, falls 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:
- Visual Studio oder Visual Studio Code.
- .NET SDK.
- SQLite-Paket für .NET.
Um das SQLite-Paket zu installieren, führen Sie den folgenden Befehl in Ihrem Projektverzeichnis aus:
dotnet add package Microsoft.Data.Sqlite
dotnet add package Microsoft.Data.Sqlite
Erstellen 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
);
Verwendung von Dapper mit SQLite
- Stellen Sie zunächst sicher, dass Sie die notwendigen Namespaces importiert haben:
using Microsoft.Data.Sqlite;
using Dapper;
using Microsoft.Data.Sqlite;
using Dapper;
Imports Microsoft.Data.Sqlite
Imports Dapper
-
Stellen 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 }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 Using$vbLabelText $csharpLabel -
Fü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 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 user$vbLabelText $csharpLabel -
Fü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 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)$vbLabelText $csharpLabel
Einführung in IronPDF
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 für .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:
- HTML-zu-PDF-Konvertierung: Konvertieren Sie HTML-Inhalte, einschließlich CSS-Stile, in PDF-Dokumente.
- Bild-zu-PDF-Konvertierung: Konvertieren Sie Bilder (wie JPEG, PNG, BMP) in PDF-Dokumente.
- Text-zu-PDF-Konvertierung: Konvertieren Sie einfachen Text oder formatierten Text (RTF) in PDF-Dokumente.
- PDF-Erstellung: Erstellen Sie PDF-Dokumente von Grund auf programmatisch.
- PDF-Bearbeitung: Bearbeiten Sie bestehende PDF-Dokumente, indem Sie Text, Bilder und andere Elemente hinzufügen oder modifizieren.
- PDF-Zusammenführung und -Aufteilung: Kombinieren Sie mehrere PDF-Dokumente zu einem einzigen Dokument oder teilen Sie ein PDF-Dokument in mehrere Dateien auf.
- PDF-Sicherheit: Wenden Sie Passwortschutz und Verschlüsselung auf PDF-Dokumente an, um den Zugriff zu beschränken und sensible Informationen zu schützen.
- PDF-Formularausfüllung: Füllen Sie PDF-Formulare programmatisch mit Daten aus.
- PDF-Druck: Drucken Sie PDF-Dokumente direkt aus Ihrer .NET-Anwendung.
- PDF-Konvertierungseinstellungen: Passen Sie verschiedene Einstellungen wie Seitengröße, Ausrichtung, Ränder, Kompression und mehr während der PDF-Erstellung an.
- PDF-Textextraktion: Extrahieren Sie Textinhalte aus PDF-Dokumenten zur weiteren Verarbeitung oder Analyse.
- PDF-Metadaten: Setzen Sie Metadaten (Autor, Titel, Betreff, Schlüsselwörter) für PDF-Dokumente.
Erstellung von PDF-Dokumenten mit IronPDF und Dapper
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 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

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>";
}
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 Microsoft.VisualBasic
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
Private connectionString As String = "Data Source=ironPdf.db"
' Create a string to hold the content for the PDF document
Private content = "<h1>Demonstrate IronPDF with Dapper</h1>"
' Add HTML content
Private content &= "<h2>Create a new database using Microsoft.Data.Sqlite</h2>"
Private content &= "<p>new SqliteConnection(connectionString) and connection.Open()</p>"
' Open the database connection
Using 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
Dim sql As String = "CREATE TABLE IF NOT EXISTS Users (" & vbLf & " Id INTEGER PRIMARY KEY," & vbLf & " Name TEXT," & vbLf & " Email TEXT" & vbLf & ");"
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 user
' Create PDF from the accumulated HTML content
Dim renderer = 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
'INSTANT VB TODO TASK: Local functions are not converted by Instant VB:
'string AddUser(SqliteConnection sqliteConnection, User user)
'{
' string insertQuery = "INSERT INTO Users (Name, Email) VALUES (@Name, @Email)";
' sqliteConnection.Execute(insertQuery, user);
' Return string.Format("<p>Name:{0}, email: {1}</p>", user.Name, user.Email);
'}
Code-Erklärung
- Beginnen Sie mit der Erstellung eines String-Inhaltshalters für die PDF-Erstellung.
- Erstellen Sie eine neue Datenbank mit
Microsoft.Data.Sqlite,connection.Open()erstellt eine leere Datenbank. - Erstellen Sie mit Dapper eine
UsersTabelle und führen Sie SQL-Abfragen zum Einfügen aus. - Fügen Sie Benutzer mit Einfügungsabfragen in die Tabelle mit Dapper hinzu.
- Abfrage, um alle Benutzer aus der Datenbank auszuwählen.
- Speichern Sie den generierten Inhalt als PDF mithilfe der von IronPDF bereitgestellten Methoden
ChromePdfRendererundSaveAs.
Ausgabe

Lizenz (Testversion für IronPDF verfügbar)
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 angezeigten Datei appSettings.json:
{
"IronPdf.License.LicenseKey" : "The Key Goes Here"
}
Abschluss
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.
Häufig gestellte Fragen
Was ist Dapper in C#?
Dapper ist ein objekt-relationales Mapping (ORM) Framework für die .NET-Plattform, bekannt für seine Geschwindigkeit und Leistung. Es ermöglicht Entwicklern, ein objektorientiertes Domänenmodell mit einer herkömmlichen relationalen Datenbank zu verknüpfen.
Wie verbessert Dapper die Leistung bei Datenbankoperationen?
Dapper verbessert die Leistung, indem es leichtgewichtig ist und Objekte effizient abbildet. Es erreicht die Geschwindigkeit eines reinen ADO.NET-Datenlesers und erweitert die IDbConnection-Schnittstelle mit nützlichen Erweiterungsmethoden zum Abfragen von SQL-Datenbanken.
Wie kann ich asynchronen Datenzugriff mit Dapper durchführen?
Dapper bietet asynchrone Erweiterungsmethoden wie QueryAsync, QueryFirstOrDefaultAsync und ExecuteAsync, die es Entwicklern ermöglichen, Datenbankabfragen asynchron auszuführen, ideal für E/A-gebundene Operationen.
Wie integriere ich die PDF-Erstellung in eine .NET-Anwendung?
Sie können die PDF-Erstellung in eine .NET-Anwendung mit IronPDF integrieren. Es ermöglicht die programmatische Erstellung, Bearbeitung und Manipulation von PDF-Dokumenten, einschließlich der Umwandlung von HTML, Bildern und Text in PDFs sowie der Bearbeitung bestehender PDFs.
Wie richte ich die Umgebung für die Verwendung von Dapper mit SQLite ein?
Um die Umgebung einzurichten, benötigen Sie Visual Studio oder Visual Studio Code, das .NET SDK und das SQLite-Paket für .NET. Sie können diese Pakete mit dem dotnet CLI installieren.
Wie kann ich einen PDF-Bericht aus den Ergebnissen von Datenbankabfragen erstellen?
Verwenden Sie IronPDF, um einen PDF-Bericht aus den Ergebnissen von Datenbankabfragen zu erstellen, indem Sie zuerst die Daten mit Dapper abrufen und dann die Ausgabe mit den Funktionen von IronPDF als PDF formatieren.
Wie erstelle und frage ich eine SQLite-Datenbank mit Dapper in C#?
Erstellen Sie eine SQLite-Datenbank, indem Sie eine Verbindung mit SqliteConnection herstellen und SQL-Abfragen mit Dappers Execute-Methode ausführen. Sie können die Datenbank mit der Query-Methode von Dapper abfragen, um Daten effizient abzurufen.
Kann Dapper komplexe Datenbeziehungen handhaben?
Ja, Dapper kann Eins-zu-Viele- und Viele-zu-Viele-Beziehungen mit seinen Multi-Mapping-Fähigkeiten handhaben, die die komplexe Datenabfrage vereinfachen.
Was sind die Vorteile einer PDF-Generierungsbibliothek in .NET?
Eine PDF-Generierungsbibliothek wie IronPDF verbessert .NET-Anwendungen, indem sie nahtlose PDF-Erstellung und -Manipulation ermöglicht und Funktionen wie HTML-zu-PDF-Konvertierung, PDF-Bearbeitung, Zusammenführen, Aufteilen und Sicherheitsfunktionen bietet.
Wie erhalte ich eine Testlizenz für IronPDF?
Eine Testlizenz für IronPDF kann über die IronPDF-Testlizenzseite bezogen werden. Der Lizenzschlüssel muss in die Projektkonfiguration eingebunden werden.




