C# PostgreSQL (jak to działa dla programistów)

Instalacja Npgsql

Otwórz nowo utworzony projekt w Visual Studio. Kliknij prawym przyciskiem myszy na swój projekt w Eksploratorze rozwiązań, wybierz "Zarządzaj pakietami NuGet" i wyszukaj pakiet Npgsql. Zainstaluj go, klikając przycisk instalacji obok nazwy pakietu. To działanie dodaje dostawcę danych Npgsql do Twojego projektu, umożliwiając Twojej aplikacji komunikację z PostgreSQL. Możesz go również zainstalować za pomocą konsoli menedżera pakietów.

Konfigurowanie połączenia z bazą danych

Pierwszym krokiem w interakcji z bazą danych PostgreSQL z C# jest ustanowienie połączenia. Wymaga to ciągu połączenia, który zawiera szczegóły takie jak nazwa serwera, port, nazwa użytkownika i hasło. Oto podstawowy szablon dla ciągu połączenia PostgreSQL:

string connectionString = "Host=localhost; Port=5432; Username=postgres; Password=yourpassword; Database=mydatabase";

string connectionString = "Host=localhost; Port=5432; Username=postgres; Password=yourpassword; Database=mydatabase";

Dim connectionString As String = "Host=localhost; Port=5432; Username=postgres; Password=yourpassword; Database=mydatabase"

Zamień localhost, yourpassword i mydatabase na szczegóły swojego serwera PostgreSQL.

Definiowanie modelu Pracownika

Definiujemy model encji Employee, który będzie reprezentował nasze dane w bazie danych PostgreSQL. Ten model zawiera właściwości, które odpowiadają kolumnom w tabeli bazy danych.

public class Employee
{
    public int Id { get; set; } // Automatically becomes the primary key
    public string LastName { get; set; }
}

public class Employee
{
    public int Id { get; set; } // Automatically becomes the primary key
    public string LastName { get; set; }
}

Public Class Employee
	Public Property Id() As Integer ' -  Automatically becomes the primary key
	Public Property LastName() As String
End Class

Ten fragment kodu definiuje prostą klasę Employee z dwoma właściwościami: Id i LastName. Entity Framework Core używa konwencji do wnioskowania, że właściwość Id serial primary key powinna być traktowana jako klucz podstawowy.

Konfigurowanie DbContext aplikacji

Klasa AppDbContext rozszerza DbContext z Entity Framework Core, działając jako pomost między Twoją aplikacją C# a bazą danych PostgreSQL. Zawiera szczegóły konfiguracyjne takie jak ciąg połączenia i właściwości DbSet, które reprezentują tabele w bazie danych.

public class AppDbContext : DbContext
{
    public DbSet<Employee> Employees { get; set; } // Represents the Employees table

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        string connectionString = "Host=localhost; Port=5432; Username=postgres; Password=your_password; Database=your_database";
        optionsBuilder.UseNpgsql(connectionString);
    }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity<Employee>().ToTable("Employees");
    }
}

public class AppDbContext : DbContext
{
    public DbSet<Employee> Employees { get; set; } // Represents the Employees table

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        string connectionString = "Host=localhost; Port=5432; Username=postgres; Password=your_password; Database=your_database";
        optionsBuilder.UseNpgsql(connectionString);
    }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity<Employee>().ToTable("Employees");
    }
}

Public Class AppDbContext
	Inherits DbContext

	Public Property Employees() As DbSet(Of Employee) ' -  Represents the Employees table

	Protected Overrides Sub OnConfiguring(ByVal optionsBuilder As DbContextOptionsBuilder)
		Dim connectionString As String = "Host=localhost; Port=5432; Username=postgres; Password=your_password; Database=your_database"
		optionsBuilder.UseNpgsql(connectionString)
	End Sub

	Protected Overrides Sub OnModelCreating(ByVal modelBuilder As ModelBuilder)
		modelBuilder.Entity(Of Employee)().ToTable("Employees")
	End Sub
End Class

Właściwość DbSet: public DbSet Employees { get; set; } deklaruje zestaw* jednostek Employee*, które są mapowane do tabeli pracowników w bazie danych PostgreSQL.

• Metoda OnConfiguring: Ta metoda konfiguruje DbContext z niezbędnym ciągiem połączenia bazy danych. Zamień your_password i your_database na swoje rzeczywiste szczegóły serwera PostgreSQL.

• Metoda OnModelCreating: Tutaj można użyć Fluent API do dalszej konfiguracji zachowań encji. W tym przykładzie określamy nazwę tabeli jawnie, chociaż jest to opcjonalne, jeśli nazwa tabeli pasuje do nazwy właściwości DbSet.

Główna logika programu

W metodzie Main klasy Program, zapewniamy stworzenie bazy danych, zasilamy ją początkowymi danymi, jeśli jest pusta, a następnie wykonujemy zapytanie w celu pobrania i wyświetlenia danych pracowników.

class Program
{
    static void Main(string[] args)
    {
        using (var context = new AppDbContext())
        {
            context.Database.EnsureCreated();  // Ensure the database and schema are created
            if (!context.Employees.Any())  // Check if the Employees table is empty
            {
                context.Employees.Add(new Employee { LastName = "Software" });
                context.SaveChanges();  // Save changes to the database
            }
            var employees = context.Employees.Where(e => e.LastName == "Software").ToList();
            foreach (var employee in employees)
            {
                Console.WriteLine($"Employee ID: {employee.Id}, Last Name: {employee.LastName}");
            }
        }
    }
}

class Program
{
    static void Main(string[] args)
    {
        using (var context = new AppDbContext())
        {
            context.Database.EnsureCreated();  // Ensure the database and schema are created
            if (!context.Employees.Any())  // Check if the Employees table is empty
            {
                context.Employees.Add(new Employee { LastName = "Software" });
                context.SaveChanges();  // Save changes to the database
            }
            var employees = context.Employees.Where(e => e.LastName == "Software").ToList();
            foreach (var employee in employees)
            {
                Console.WriteLine($"Employee ID: {employee.Id}, Last Name: {employee.LastName}");
            }
        }
    }
}

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Using context = New AppDbContext()
			context.Database.EnsureCreated() ' Ensure the database and schema are created
			If Not context.Employees.Any() Then ' Check if the Employees table is empty
				context.Employees.Add(New Employee With {.LastName = "Software"})
				context.SaveChanges() ' Save changes to the database
			End If
			Dim employees = context.Employees.Where(Function(e) e.LastName = "Software").ToList()
			For Each employee In employees
				Console.WriteLine($"Employee ID: {employee.Id}, Last Name: {employee.LastName}")
			Next employee
		End Using
	End Sub
End Class

Powyższy kod sprawdza, czy baza danych istnieje i tworzy ją wraz ze schematem, jeśli nie istnieje. To prosta metoda inicjalizacji nowej bazy danych podczas rozwoju. To polecenie SQL sprawdza, czy tabela Employees jest pusta, program dodaje nowego Employee z nazwiskiem "Software" i zapisuje zmiany w bazie danych. Program wykonuje zapytanie w tabeli Employees o wpisy z nazwiskiem "Software" i drukuje ich szczegóły na konsoli.

Wynik

Oto wynik wyświetlany w konsoli po uruchomieniu programu:

I to są dane tabeli w PgAdmin:

Instalacja IronPDF

Zanim będziesz mógł użyć IronPDF, musisz dodać go do swojego projektu. To można łatwo zrobić poprzez Menedżera pakietów NuGet:

Install-Package IronPdf

Generowanie PDF z danych PostgreSQL

W tym przykładzie wygenerujmy prosty raport PDF, który wymienia pracowników z naszej bazy danych PostgreSQL. Zakładamy, że masz skonfigurowany AppDbContext i model Employee, jak opisano w poprzednich sekcjach.

Najpierw upewnij się, że masz zainstalowaną bibliotekę IronPDF w Twoim projekcie. Następnie możesz użyć następującego kodu, aby pobrać dane z bazy danych PostgreSQL i wygenerować raport PDF:

class Program
{
    static void Main(string[] args)
    {
        IronPdf.License.LicenseKey = "Key";
        // Initialize the database context
        using (var context = new AppDbContext())
        {
            // Fetch employees from the database
            var employees = context.Employees.ToList();
            // Generate HTML content for the PDF
            var htmlContent = "<h1>Employee Report</h1>";
            htmlContent += "<table><tr><th>ID</th><th>Last Name</th></tr>";
            foreach (var employee in employees)
            {
                htmlContent += $"<tr><td>{employee.Id}</td><td>{employee.LastName}</td></tr>";
            }
            htmlContent += "</table>";
            // Instantiate the IronPDF HtmlToPdf converter
            var renderer = new ChromePdfRenderer();
            // Generate the PDF document from the HTML content
            var pdf = renderer.RenderHtmlAsPdf(htmlContent);
            // Save the generated PDF to a file
            var outputPath = "f:\\EmployeeReport.pdf";
            pdf.SaveAs(outputPath);
            Console.WriteLine($"PDF report generated: {outputPath}");
        }
    }
}

class Program
{
    static void Main(string[] args)
    {
        IronPdf.License.LicenseKey = "Key";
        // Initialize the database context
        using (var context = new AppDbContext())
        {
            // Fetch employees from the database
            var employees = context.Employees.ToList();
            // Generate HTML content for the PDF
            var htmlContent = "<h1>Employee Report</h1>";
            htmlContent += "<table><tr><th>ID</th><th>Last Name</th></tr>";
            foreach (var employee in employees)
            {
                htmlContent += $"<tr><td>{employee.Id}</td><td>{employee.LastName}</td></tr>";
            }
            htmlContent += "</table>";
            // Instantiate the IronPDF HtmlToPdf converter
            var renderer = new ChromePdfRenderer();
            // Generate the PDF document from the HTML content
            var pdf = renderer.RenderHtmlAsPdf(htmlContent);
            // Save the generated PDF to a file
            var outputPath = "f:\\EmployeeReport.pdf";
            pdf.SaveAs(outputPath);
            Console.WriteLine($"PDF report generated: {outputPath}");
        }
    }
}

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		IronPdf.License.LicenseKey = "Key"
		' Initialize the database context
		Using context = New AppDbContext()
			' Fetch employees from the database
			Dim employees = context.Employees.ToList()
			' Generate HTML content for the PDF
			Dim htmlContent = "<h1>Employee Report</h1>"
			htmlContent &= "<table><tr><th>ID</th><th>Last Name</th></tr>"
			For Each employee In employees
				htmlContent &= $"<tr><td>{employee.Id}</td><td>{employee.LastName}</td></tr>"
			Next employee
			htmlContent &= "</table>"
			' Instantiate the IronPDF HtmlToPdf converter
			Dim renderer = New ChromePdfRenderer()
			' Generate the PDF document from the HTML content
			Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
			' Save the generated PDF to a file
			Dim outputPath = "f:\EmployeeReport.pdf"
			pdf.SaveAs(outputPath)
			Console.WriteLine($"PDF report generated: {outputPath}")
		End Using
	End Sub
End Class

Wynik

Po uruchomieniu kodu, konsola wyświetli:

Ten PDF jest generowany: