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

1.1 使用 Npgsql 的優勢

效能： Npgsql 的速度和效率是內建的。 為了確保在使用 PostgreSQL 資料庫時達到最佳速度，它利用了批次命令、非同步輸入/輸出和最佳化資料類型等功能。

完整的 PostgreSQL 支援： Npgsql 的目標是提供對 PostgreSQL 所有功能的完整支持，例如陣列、JSONB、進階資料類型和使用者自訂類型。這意味著程式設計師可以在其 .NET 應用程式中充分利用 PostgreSQL 的全部潛力。

1.2 Npgsql入門

using Npgsql;
using System;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        // PostgreSQL connection string
        string connString = "Host=myServerAddress;Port=myPort;Username=myUsername;Password=myPassword;Database=myDatabase";

        // Create connection object
        using (var conn = new NpgsqlConnection(connString))
        {
            // Open the connection
            await conn.OpenAsync();

            // SQL query to execute
            string sql = "SELECT * FROM myTable";

            // Create NpgsqlCommand
            using (var cmd = new NpgsqlCommand(sql, conn))
            {
                // Execute the command and retrieve data
                using (var reader = await cmd.ExecuteReaderAsync())
                {
                    // Loop through the retrieved data
                    while (await reader.ReadAsync())
                    {
                        // Retrieve data from the data reader
                        string name = reader["Name"].ToString();
                        int age = Convert.ToInt32(reader["Age"]);
                        // Output retrieved data to console
                        Console.WriteLine($"Name: {name}, Age: {age}");
                    }
                }
            }
            // Connection will be automatically closed here due to the 'using' block
        }
    }
}

using Npgsql;
using System;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        // PostgreSQL connection string
        string connString = "Host=myServerAddress;Port=myPort;Username=myUsername;Password=myPassword;Database=myDatabase";

        // Create connection object
        using (var conn = new NpgsqlConnection(connString))
        {
            // Open the connection
            await conn.OpenAsync();

            // SQL query to execute
            string sql = "SELECT * FROM myTable";

            // Create NpgsqlCommand
            using (var cmd = new NpgsqlCommand(sql, conn))
            {
                // Execute the command and retrieve data
                using (var reader = await cmd.ExecuteReaderAsync())
                {
                    // Loop through the retrieved data
                    while (await reader.ReadAsync())
                    {
                        // Retrieve data from the data reader
                        string name = reader["Name"].ToString();
                        int age = Convert.ToInt32(reader["Age"]);
                        // Output retrieved data to console
                        Console.WriteLine($"Name: {name}, Age: {age}");
                    }
                }
            }
            // Connection will be automatically closed here due to the 'using' block
        }
    }
}

2.1 使用 PostgreSQL 進行參數化查詢

由於參數化查詢能夠讓資料庫伺服器快取查詢計劃，因此可以提高查詢效能並有助於防止 SQL 注入攻擊。 Npgsql支援參數化查詢。 此外，使用參數化查詢可以更安全有效地處理動態 SQL 查詢。

2.2 使用 PostgreSQL 進行批次操作

處理海量資料集時，Npgsql 支援的批次插入、更新和刪除操作可以大幅提高速度。 由於批次操作可以在單一資料庫事務中處理多行數據，因此可以減少與資料庫伺服器多次往返的開銷。

使用 PostgreSQL 進行事務處理

Npgsql 支援事務，可以將多個資料庫操作組合成一個原子單元。 交易透過將所有變更提交到資料庫或在出錯時回滾整個事務來提供資料的一致性和完整性。

2.3 使用 PostgreSQL 進行效能優化

在使用 PostgreSQL 資料庫時，Npgsql 提供了許多效能增強功能，包括查詢計劃快取、結果流和命令批次處理，以減少延遲並提高吞吐量。 這些改進提升了應用程式的可擴展性和整體運行速度。

2.4 與 PostgreSQL 資料庫的連接

借助 Npgsql，只需以下幾行程式碼即可輕鬆連接 PostgreSQL 資料庫伺服器。

NpgsqlConnection conn = new NpgsqlConnection(connString);

NpgsqlConnection conn = new NpgsqlConnection(connString);

這段基本程式碼片段可以幫助我們連接到 PostgreSQL 資料庫伺服器。

3.1 共同使用 Npgsql 和 IronPDF

在 C# 專案中將 Npgsql 和 IronPDF 結合使用，會產生令人興奮的可能性。 雖然 Npgsql 是一個很棒的 PostgreSQL 處理工具，但 IronPDF 是一個很棒的將這些內容轉換為 PDF 的工具。 由於這種連接性，程式設計師可以設計出能夠與資料庫通訊並將這些內容轉換為 PDF 的應用程式。

3.2 使用 IronPDF 取得 PostgreSQL 數據

用戶可以透過建立使用 Npgsql 的 Windows 控制台應用程序，在您的應用程式中與資料庫進行互動。 首先在應用程式中新增資料庫存取權限。控制台上應該有足夠的空間來放置此控件，並為資料庫互動留出充足的空間。 同時包括資料類型映射和批次操作。

安裝 IronPDF

• 在 Visual Studio 中啟動專案。

• 選擇"工具">"NuGet 套件管理員">"套件管理員控制台"。

  • 在軟體包管理器控制台中輸入以下命令並按 Enter 鍵：

  Install-Package IronPdf

• 或者，您也可以使用 NuGet 解決方案套件管理器安裝 IronPDF。
  • 在搜尋結果中找到 IronPDF 軟體包，選擇它，然後按一下"安裝"按鈕。 Visual Studio 將自動處理下載和安裝。

! Npgsql C#（開發人員的使用方法）：圖 3 - 使用 NuGet 套件管理器的搜尋列中搜尋"IronPdf"，然後選擇專案並點擊"安裝"按鈕，即可透過"管理解決方案的 NuGet 套件"安裝 IronPDF。

• IronPDF 套件將透過 NuGet 下載並安裝，同時也安裝專案所需的任何相依性。 安裝完成後，您即可開始在專案中使用 IronPDF。

透過 NuGet 網站安裝

有關 IronPDF 的更多信息，包括功能、相容性和其他下載選項，請訪問NuGet 網站上的 IronPDF 軟體包。

利用 DLL 進行安裝

或者，您可以使用 IronPDF 的 DLL 檔案將其直接整合到您的專案中。 使用此IronPDF ZIP 套件連結下載包含 DLL 的 ZIP 檔案。 解壓縮後，將 DLL 檔案新增至您的專案。

實作邏輯

當我們開始運行該應用程式時，它將使用 Npgsql .NET 程式庫從資料庫中取得資料。 使用 IronPDF，我們可以將資料庫內容轉換為 PDF 文件。

1.取得資料：當使用者開始轉換時，從 Npgsql .NET 提供者取得最新內容。 2.使用 IronPDF 產生 PDF：要將 Npgsql 資料庫中的資料轉換為 PDF，請使用 IronPDF。 可以使用 HtmlToPdf 類別將 HTML 字串格式化為 PDF 文件。 3.儲存 PDF 並通知：將產生的 PDF 儲存到指定位置，或在控制台上留下可見訊息。 PDF 儲存後，透過終端訊息等方式通知使用者轉換成功。

using Npgsql;
using IronPdf;
using System;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        // StringBuilder for HTML content
        StringBuilder sb = new StringBuilder();
        var Renderer = new ChromePdfRenderer(); // Instantiates Chrome Renderer

        sb.Append("<h1>Dynamic PDF Generated from PostgreSQL Data</h1>");

        // PostgreSQL connection setup
        string connString = "Host=myServerAddress;Port=myPort;Username=myUsername;Password=myPassword;Database=myDatabase";

        using (var conn = new NpgsqlConnection(connString))
        {
            await conn.OpenAsync();

            string sql = "SELECT * FROM myTable";
            using (var cmd = new NpgsqlCommand(sql, conn))
            {
                using (var reader = await cmd.ExecuteReaderAsync())
                {
                    while (await reader.ReadAsync())
                    {
                        // Retrieve data from the data reader
                        string name = reader["Name"].ToString();
                        int age = Convert.ToInt32(reader["Age"]);

                        // Add data to the PDF
                        sb.Append($"<p>Name: {name}, Age: {age}</p>");
                    }
                }
            }

            // Generate and save the PDF document
            var pdf = Renderer.RenderHtmlAsPdf(sb.ToString());
            pdf.SaveAs("output.pdf");

            // Connection will be automatically closed here
        }

        Console.WriteLine("PDF generation completed. See output.pdf for results.");
    }
}

using Npgsql;
using IronPdf;
using System;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        // StringBuilder for HTML content
        StringBuilder sb = new StringBuilder();
        var Renderer = new ChromePdfRenderer(); // Instantiates Chrome Renderer

        sb.Append("<h1>Dynamic PDF Generated from PostgreSQL Data</h1>");

        // PostgreSQL connection setup
        string connString = "Host=myServerAddress;Port=myPort;Username=myUsername;Password=myPassword;Database=myDatabase";

        using (var conn = new NpgsqlConnection(connString))
        {
            await conn.OpenAsync();

            string sql = "SELECT * FROM myTable";
            using (var cmd = new NpgsqlCommand(sql, conn))
            {
                using (var reader = await cmd.ExecuteReaderAsync())
                {
                    while (await reader.ReadAsync())
                    {
                        // Retrieve data from the data reader
                        string name = reader["Name"].ToString();
                        int age = Convert.ToInt32(reader["Age"]);

                        // Add data to the PDF
                        sb.Append($"<p>Name: {name}, Age: {age}</p>");
                    }
                }
            }

            // Generate and save the PDF document
            var pdf = Renderer.RenderHtmlAsPdf(sb.ToString());
            pdf.SaveAs("output.pdf");

            // Connection will be automatically closed here
        }

        Console.WriteLine("PDF generation completed. See output.pdf for results.");
    }
}

以下是上述程式碼產生的運行結果。 要了解有關IronPDF 文件的更多信息，請參閱該指南。

! Npgsql C#（開發人員的工作原理）：圖 4 - 使用來自 Npgsql PostgreSQL 資料庫和 IronPDF 的資料產生的輸出 PDF。