C# PostgreSQL（開發者使用指南）

安裝 Npgsql

在 Visual Studio 中開啟你新建的專案。 在解決方案資源管理器中右鍵單擊您的項目，選擇"管理 NuGet 套件"，然後搜尋 Npgsql 套件。 點擊軟體包名稱旁的安裝按鈕即可安裝。 此操作會將 Npgsql 資料提供者新增至您的專案中，使您的應用程式能夠與 PostgreSQL 通訊。 您也可以使用軟體套件管理器控制台進行安裝。

C# PostgreSQL（開發者如何操作）：圖 1 - Npgsql

配置資料庫連接

從 C# 與 PostgreSQL 資料庫互動的第一步是建立連線。 這需要一個連接字串，其中包含伺服器名稱、連接埠、使用者名稱和密碼等詳細資訊。 以下是一個基本的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";

將localhost 、 yourpassword和mydatabase替換為您的 PostgreSQL 伺服器的詳細資訊。

定義員工模型

我們定義了一個員工實體模型，該模型將表示我們在 PostgreSQL 資料庫中的資料。 此模型包含與資料庫表中的列相對應的屬性。

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

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

這段程式碼定義了一個簡單的Employee類別，它有兩個屬性： Id和LastName 。 Entity Framework Core 使用約定來推斷Id序列主鍵屬性應該被視為主鍵。

配置應用程式的 DbContext

AppDbContext類別繼承自 Entity Framework Core 中的DbContext ，充當 C# 應用程式和 PostgreSQL 資料庫之間的橋樑。 它包含配置詳細信息，例如連接字串和表示資料庫中表的DbSet屬性。

public class AppDbContext : DbContext
{
    public DbSet<Employee> Employees { get; 放; } // 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; 放; } // 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");
    }
}

• DbSet 屬性：**公共資料庫集員工 { 取得; 放; }宣告一個員工集合。**對應到 PostgreSQL 資料庫中 employee 表的實體。

• OnConfiguring 方法：此方法使用必要的資料庫連接字串配置DbContext 。 請將your_password和your_database替換為您的實際 PostgreSQL 伺服器詳細資訊。

• OnModelCreating 方法：您可以在此使用 Fluent API 進一步配置實體行為。 在這個例子中，我們明確指定了表名，不過如果表名與DbSet屬性名匹配，則表名是可選的。

主程式邏輯

在Program類別的Main方法中，我們確保資料庫已創建，如果為空則以初始資料填充，然後執行查詢以檢索和顯示員工資料。

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}");
            }
        }
    }
}

上述程式碼檢查資料庫是否存在，如果不存在，則建立資料庫及其架構。 這是在開發過程中引導新資料庫的簡單方法。 此 SQL 語句會檢查員工表是否為空，如果為空，程式會新增姓氏為"Software"的新員工，並將變更儲存到資料庫。 此程式會查詢員工表中姓氏為"Software"的條目，並將其詳細資料列印到控制台。

輸出

以下是執行程式時的控制台輸出：

C# PostgreSQL（開發者使用指南）：圖 2 - 輸出

這是 PgAdmin 中的表格資料：

C# PostgreSQL（開發者使用指南）：圖 3 - 表輸出

安裝 IronPDF

使用 IronPDF 之前，必須先將其新增至項目。 這可以透過 NuGet 套件管理器輕鬆完成：

Install-Package IronPdf

從 PostgreSQL 資料生成 PDF

在這個範例中，我們產生一個簡單的 PDF 報告，列出 PostgreSQL 資料庫中的員工。 我們假設您已經按照前面章節的說明設定了AppDbContext和Employee模型。

首先，請確保您的專案中已安裝 IronPDF 庫。 然後，您可以使用以下程式碼從 PostgreSQL 資料庫中取得資料並產生 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}");
        }
    }
}

輸出

運行程式碼後，控制台將顯示以下輸出：

C# PostgreSQL（開發者使用指南）：圖 4 - 控制台輸出

已產生此PDF檔案：

C# PostgreSQL（開發者使用指南）：圖 5 - PDF 輸出