Nachrichtensymbol
Zum Fußzeileninhalt springen
  1. IronPDF
  2. IronPDF Blog
  3. .NET Hilfe
  4. Dapper C#
.NET HILFE

Dapper C# (Funktionsweise für Entwickler)

Jacob Mellor, Chief Technology Officer @ Team Iron
Jacob Mellor
Aktualisiert:

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

  1. Leistung: Dapper ist für seine hervorragende Leistung bekannt, die auf sein leichtes Design und sein effizientes Objektmapping zurückzuführen ist.
  2. Einfachheit: Die Dapper-API ist minimalistisch und intuitiv gestaltet, sodass Entwickler sie leicht verstehen und effektiv nutzen können.
  3. 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.
  4. Objektmapping: Dapper ordnet Abfrageergebnisse direkt C#-Objekten zu, wodurch Boilerplate-Code reduziert und die Lesbarkeit des Codes verbessert wird.
  5. Parametrisierte Abfragen: Dapper unterstützt parametrisierte Abfragen, wodurch Schutz vor SQL-Injection-Angriffen geboten und die Leistung verbessert wird.
  6. 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

  1. QueryAsync : Führt eine SQL-Abfrage asynchron aus und gibt das Ergebnis als Sequenz dynamischer Objekte oder stark typisierter Objekte zurück.
  2. QueryFirstOrDefaultAsync : Führt eine SQL-Abfrage asynchron aus und gibt das erste Ergebnis oder einen Standardwert zurück, falls kein Ergebnis gefunden wird.
  3. 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:

  1. Visual Studio oder Visual Studio Code.
  2. .NET SDK.
  3. 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
SHELL

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

  1. Stellen Sie zunächst sicher, dass Sie die notwendigen Namespaces importiert haben:
using Microsoft.Data.Sqlite;
using Dapper;
using Microsoft.Data.Sqlite;
using Dapper;
$vbLabelText   $csharpLabel

  1. 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
}
    $vbLabelText   $csharpLabel

  2. 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}");
}
    $vbLabelText   $csharpLabel

  3. 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);
    $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:

  1. HTML-zu-PDF-Konvertierung: Konvertieren Sie HTML-Inhalte, einschließlich CSS-Stile, in PDF-Dokumente.
  2. Bild-zu-PDF-Konvertierung: Konvertieren Sie Bilder (wie JPEG, PNG, BMP) in PDF-Dokumente.
  3. Text-zu-PDF-Konvertierung: Konvertieren Sie einfachen Text oder formatierten Text (RTF) in PDF-Dokumente.
  4. PDF-Erstellung: Erstellen Sie PDF-Dokumente von Grund auf programmatisch.
  5. PDF-Bearbeitung: Bearbeiten Sie bestehende PDF-Dokumente, indem Sie Text, Bilder und andere Elemente hinzufügen oder modifizieren.
  6. PDF-Zusammenführung und -Aufteilung: Kombinieren Sie mehrere PDF-Dokumente zu einem einzigen Dokument oder teilen Sie ein PDF-Dokument in mehrere Dateien auf.
  7. PDF-Sicherheit: Wenden Sie Passwortschutz und Verschlüsselung auf PDF-Dokumente an, um den Zugriff zu beschränken und sensible Informationen zu schützen.
  8. PDF-Formularausfüllung: Füllen Sie PDF-Formulare programmatisch mit Daten aus.
  9. PDF-Druck: Drucken Sie PDF-Dokumente direkt aus Ihrer .NET-Anwendung.
  10. PDF-Konvertierungseinstellungen: Passen Sie verschiedene Einstellungen wie Seitengröße, Ausrichtung, Ränder, Kompression und mehr während der PDF-Erstellung an.
  11. PDF-Textextraktion: Extrahieren Sie Textinhalte aus PDF-Dokumenten zur weiteren Verarbeitung oder Analyse.
  12. 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

Dapper C# (How It Works For Developers): Abbildung 1 - Erstellen einer Konsolenanwendung in Visual Studio

Geben Sie den Projektnamen und den Speicherort an

Dapper C# (How It Works For Developers): Abbildung 2 - Benennung des Projekts

Wählen Sie die .NET-Version aus

Dapper C# (How It Works For Developers): Abbildung 3 - Gewünschte .NET-Version auswählen

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
SHELL

Dapper C# (How It Works For Developers): Abbildung 4 - Microsoft Data Sqlite aus dem Visual Studio-Paket-Manager installieren

dotnet add package Dapper --version 2.1.35
dotnet add package Dapper --version 2.1.35
SHELL

Dapper C# (How It Works For Developers): Abbildung 5 - Dapper aus dem Visual Studio-Paket-Manager installieren

dotnet add package IronPdf --version 2024.4.2
dotnet add package IronPdf --version 2024.4.2
SHELL

Dapper C# (How It Works For Developers): Abbildung 6 - IronPDF aus dem Visual Studio-Paket-Manager installieren

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>"; 
}
$vbLabelText   $csharpLabel

Code-Erklärung

  1. Beginnen Sie mit der Erstellung eines String-Inhaltshalters für die PDF-Erstellung.
  2. Erstellen Sie eine neue Datenbank mit Microsoft.Data.Sqlite, connection.Open() erstellt eine leere Datenbank.
  3. Erstellen Sie eine Users-Tabelle mit Dapper und führen Sie SQL-Abfragen zur Einfügung aus.
  4. Fügen Sie Benutzer mit Einfügungsabfragen in die Tabelle mit Dapper hinzu.
  5. Abfrage, um alle Benutzer aus der Datenbank auszuwählen.
  6. Speichern Sie den generierten Inhalt als PDF mit den ChromePdfRenderer und SaveAs-Methoden, die von IronPDF bereitgestellt werden.

Ausgabe

Dapper C# (How It Works For Developers): Abbildung 7 - Beispiel-PDF-Ausgabe unter Verwendung aller oben installierten Pakete

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 gezeigten appSettings.json-Datei:

{
  "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.

Jacob Mellor, Chief Technology Officer @ Team Iron
Jacob Mellor
  Jetzt mit dem Ingenieurteam chatten
Chief Technology Officer

Jacob Mellor ist Chief Technology Officer bei Iron Software und ein visionärer Ingenieur, der führend in der C# PDF-Technologie ist. Als ursprünglicher Entwickler der Iron Software-Kerncodebasis hat er die Produktarchitektur des Unternehmens seit seiner Gründung gestaltet und zusammen mit CEO Cameron Rimington in ein Unternehmen ...

Weiterlesen

Verwandte Artikel

30-Tage-Testversion → Volles Produkt. Keine Grenzen. Keine Karte. Gratis testen