W nowoczesnym tworzeniu oprogramowania wydajny dostęp do baz danych ma kluczowe znaczenie dla wydajności i skalowalności aplikacji. Dapper, lekki mapper obiektowo-relacyjny (ORM) dla platformy .NET, oferuje usprawnione podejście do interakcji z bazami danych. W tym artykułe omówimy, jak używać Dapper C# z plikiem bazy danych SQLite, pokazując jego prostotę i skuteczność na przykładach kodu. Dodatkowo przedstawię niezwykłą bibliotekę do generowania plików PDF o nazwie IronPDF firmy Iron Software.
Dapper to framework do mapowania obiektowo-relacyjnego (ORM) dla platformy .NET Framework. Jest to prosty mapper obiektów, który pozwala na mapowanie obiektowego modelu domeny do tradycyjnej relacyjnej bazy danych. Dapper jest znany ze swojej szybkości i wydajności, często nazywany jest "królem mikro ORM". Dorównuje szybkością surowemu czytnikowi danych ADO.NET i wzbogaca interfejs IDbConnection o przydatne metody rozszerzeń do wysyłania zapytań do baz danych SQL.
Dapper oferuje asynchroniczne metody rozszerzeń, które odzwierciedlają ich synchroniczne odpowiedniki, umożliwiając programistom asynchroniczne wykonywanie zapytań do bazy danych. Te metody asynchroniczne są idealne do operacji związanych z wejściem/wyjściem, takich jak zapytania do bazy danych, gdzie główny wątek może kontynuować wykonywanie innych zadań, czekając na zakończenie operacji bazodanowej.
QueryAsync: Wykonuje zapytanie SQL asynchronicznie i zwraca wynik jako sekwencję dynamicznych obiektów lub obiektów silnie typowanych.QueryFirstOrDefaultAsync: Wykonuje zapytanie SQL asynchronicznie i zwraca pierwszy wynik lub wartość domyślną, jeśli wynik nie zostanie znaleziony.ExecuteAsync: Wykonuje polecenie SQL asynchronicznie (np. INSERT, UPDATE, DELETE) i zwraca liczbę zmodyfikowanych wierszy.Konfiguracja środowiska: Zanim przejdziesz do przykładów kodu, upewnij się, że masz zainstalowane niezbędne narzędzia:
Aby zainstalować pakiet SQLite, wykonaj następujące polecenie w katalogu projektu:
dotnet add package Microsoft.Data.SqliteTworzenie bazy danych SQLite: W celach demonstracyjnych utwórzmy prosty plik bazy danych SQLite o nazwie "example.db" z tabelą "Users" zawierającą kolumny "Id", "Name" i "Email".
CREATE TABLE Users (
Id INTEGER PRIMARY KEY,
Name TEXT,
Email TEXT
);using Microsoft.Data.Sqlite;
using Dapper;Imports Microsoft.Data.Sqlite
Imports DapperNawiąż połączenie z bazą danych 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
}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 UsingWykonaj zapytanie za pomocą 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 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 userWprowadź dane do bazy danych za pomocą 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
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 to biblioteka C# firmy Iron Software, która umożliwia programistom tworzenie, edycję i manipulowanie dokumentami PDF programowo w ramach aplikacji .NET. Oferuje funkcje takie jak generowanie dokumentów PDF z HTML, obrazów i innych formatów, a także dodawanie tekstu, obrazów i różnych elementów do istniejących plików PDF. IronPDF ma na celu uproszczenie zadań związanych z generowaniem i edycją plików PDF dla programistów .NET poprzez dostarczenie kompleksowego zestawu narzędzi i interfejsów API.
IronPDF oferuje szereg funkcji do generowania i edycji plików PDF w aplikacjach .NET:
Utwórz aplikację konsolową w Visual Studio
Podaj nazwę projektu i lokalizację
Wybierz wersję .NET
Zainstaluj następujące pakiety za pomocą Menedżera pakietów Visual Studio lub konsoli
dotnet add package Microsoft.Data.Sqlite
dotnet add package Dapper --version 2.1.35
Użyj poniższego kodu, aby wygenerować dokument 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>";
}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() utworzy pustą bazę danych.Users przy użyciu Dapper i wykonaj zapytania SQL dotyczące wstawienia.ChromePdfRenderer i SaveAs udostępnionych przez IronPDF.
Dostępne są informacje dotyczące licencji IronPDF, które pomogą zapewnić zgodność i prawidłowe wykorzystanie w ramach projektu.
Licencję Trial dla programistów można uzyskać na stronie licencji Trial IronPDF.
Proszę wymienić klucz w pliku appSettings.json pokazanym poniżej:
{
"IronPdf.License.LicenseKey" : "The Key Goes Here"
}Dapper upraszcza dostęp do danych w aplikacjach .NET, a w połączeniu z SQLite zapewnia lekkie i wydajne rozwiązanie do zarządzania bazami danych. Postępując zgodnie z instrukcjami zawartymi w tym artykułe, możesz wykorzystać Dapper do płynnej interakcji z bazami danych SQLite, co pozwoli Ci z łatwością tworzyć solidne i skalowalne aplikacje. Oprócz IronPDF programiści mogą zdobyć umiejętności związane z bazami danych ORM, takimi jak Dapper, oraz bibliotekami do generowania plików PDF, takimi jak IronPDF.
Jacob Mellor jest Chief Technology Officer w Iron Software i wizjonerskim inżynierem, pionierem technologii C# PDF. Jako pierwotny deweloper głównej bazy kodowej Iron Software, kształtuje architekturę produktów firmy od jej początku, przekształcając ją wspólnie z CEO Cameron Rimington w firmę liczącą ponad 50 osób, obsługującą NASA, Teslę i światowe agencje rządowe.
IronPDF jest częścią IRONSUITE
10 produktów API .NET dla twoich dokumentów biurowych
Kiedy potrzebujesz, aby twój PDF wyglądał jak HTML, szybko.
