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) 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.

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 bekannt für seine hervorragende Leistung dank seines leichtgewichtigen Designs und der effizienten Objektzuordnung.
  2. Einfachheit: Dappers API ist minimalistisch und intuitiv, was es Entwicklern erleichtert, sie zu verstehen und effektiv zu nutzen.
  3. Unterstützung für rohes SQL: Dapper ermöglicht Entwicklern das Schreiben von rohen SQL-Abfragen, wodurch die volle Kontrolle über Datenbankinteraktionen gewährleistet wird.
  4. Objektzuordnung: Dapper ordnet Abfrageergebnisse direkt C#-Objekten zu, reduziert Boilerplate-Code und verbessert die Code-Lesbarkeit.
  5. Parametrisierte Abfragen: Dapper unterstützt parametrisierte Abfragen, schützt vor SQL-Injection-Angriffen und verbessert die Leistung.
  6. Multi-Mapping: Dapper behandelt nahtlos One-to-Many- und Many-to-Many-Beziehungen und ermöglicht die effiziente Ausführung mehrerer Abfragen, wodurch komplexe Datenabfragen vereinfacht werden.

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 Folge von dynamischen Objekten oder stark typisierten Objekten zurück.
  2. QueryFirstOrDefaultAsync: Führt eine SQL-Abfrage asynchron aus und gibt das erste Ergebnis oder einen Standardwert zurück, wenn 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 for .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 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:

  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# (Wie es für Entwickler funktioniert): Abbildung 1 - Eine Konsolenanwendung in Visual Studio erstellen

Geben Sie den Projektnamen und den Speicherort an

Dapper C# (Wie es für Entwickler funktioniert): Abbildung 2 - Das Projekt benennen

Wählen Sie die .NET-Version aus

Dapper C# (Wie es für Entwickler funktioniert): Abbildung 3 - Die 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# (Wie es für Entwickler funktioniert): Abbildung 4 - Microsoft Data Sqlite aus dem Visual Studio-Paketmanager installieren

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

Dapper C# (Wie es für Entwickler funktioniert): Abbildung 5 - Dapper aus dem Visual Studio-Paketmanager installieren

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

Dapper C# (Wie es für Entwickler funktioniert): Abbildung 6 - IronPDF aus dem Visual Studio-Paketmanager 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. Eine neue Datenbank mit Microsoft.Data.Sqlite erstellen, connection.Open() wird eine leere Datenbank erstellen.
  3. Eine Users-Tabelle mit Dapper erstellen und SQL-Abfragen zur Einfügung ausführen.
  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. Den generierten Inhalt als PDF speichern mit den von IronPDF bereitgestellten Methoden ChromePdfRenderer und SaveAs.

Ausgabe

Dapper C# (Wie es für Entwickler funktioniert): Abbildung 7 - Beispielausgabe eines PDF, das alle oben installierten Pakete nutzt

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 for .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 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 ...

Weiterlesen

Verwandte Artikel

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

Iron Support Team

We're online 24 hours, 5 days a week.
Chat
Email
Call Me