.NET 幫助

Npgsql C# .NET（開發人員如何使用）

發佈 2024年1月27日

簡介

Npgsql 是一個功能豐富且堅固的開源數據提供者，專為尋求流暢PostgreSQL數據庫訪問和互動的.NET應用程序而創建。它作為PostgreSQL和.NET程序之間的強大連接，提供廣泛的功能、工具和優化，以實現高效的數據訪問和處理。

開發團隊或者貢獻者可能會隨著開源專案的進展而更改，並且經常有新人加入協助軟體維護和增強功能。因此，建議查看官方 Npgsql 存储库在 GitHub 或與該專案相關的其他社群頻道上，以獲取有關 Npgsql 開發團隊和貢獻者的最新資訊。

如何在C＃中使用Npgsql

創建一個新的 Visual Studio 專案。
安裝所需的庫。
為PostgreSQL數據提供者創建一個對象。
將查詢傳遞給提供者。
關閉連接並處理對象。

安裝 Npgsql

以下指示可用於安裝 Npgsql，一個適用於.PostgreSQL的.NET資料提供程序：

啟動 Visual Studio。
在工具 > NuGet 包管理器下導航到包管理器控制台。
在包管理器控制台輸入以下命令：

Install-Package Npgsql

要執行命令，請按 Enter 鍵。 Npgsql 封包將下載並安裝到您的項目中。

Npgsql .NET 提供者

Npgsql 是一個 .NET 資料提供者，使 C# 和其他 .NET 語言開發者能夠連接、存取和管理 PostgreSQL 資料庫。利用 Entity Framework Core 提供者和 ADO.NET 資料提供者的功能，它幫助開發者在他們的應用程式中充分利用 PostgreSQL。在本文中，我們將詳細了解 Npgsql。

Npgsql 的重要特徵如下：

相容性和一致性：透過支援廣泛的 PostgreSQL 專屬功能、資料類型、函式和能力，Npgsql 保證符合 PostgreSQL 標準。
高性能：其主要目標是透過使用非同步 I/O 操作及其他提升性能的策略，提供有效的資料存取和操作來優化性能。
安全性和可靠性：Npgsql 高度重視安全，包括 SSL 加密和 PostgreSQL 的安全驗證技術，確保資料庫和應用程式連接的安全。
跨平台支援：其無縫架構允許其在各種作業系統上運行，如 Windows、Linux 和 macOS，提供部署環境的靈活性。
Entity Framework 集成：開發者可以使用 LINQ 查詢和 ORM。 (物件關聯對應) 由於Npgsql與Entity Framework Core的順暢整合，與PostgreSQL數據庫進行通信的方法。
一個流行的用於PostgreSQL的輕量級連接池器叫做pgBouncer。由於pgBouncer能夠管理連接池並作為客戶端連接的代理，因此可以更有效地利用PostgreSQL服務器資源。當pgBouncer配置在PostgreSQL服務器前端時，可以通過將傳入連接分配給多個PostgreSQL實例來幫助負載均衡。

在他們的.NET應用程序中，開發人員經常使用Npgsql來創建連接、運行SQL查詢、處理事務、執行CRUD任務並維護數據庫模式。它賦予程序員創建可靠、可擴展、高性能應用程序的能力，這些應用程序與PostgreSQL數據庫協同工作良好。

由於其廣泛的功能集和定期更新，Npgsql是.NET開發人員的首選。這些開發人員希望在他們的C#或.NET應用程序中使用PostgreSQL的強大和可靠性，同時受益於靈活且維護良好的數據源。

連接 Npgsql

開發人員可以連接到 PostgreSQL 資料庫，運行 SQL 查詢，進行 CRUD 操作 (建立, 讀取, 更新, 刪除) 使用 Npgsql 來執行任務、管理交易等。

以下是一個基本的程式碼片段，顯示如何使用 Npgsql 連接到 PostgreSQL 資料庫：

using Npgsql;
using System;

class Program
{
    static void Main(string [] args)
    {
        var connectionString = "Host=myhost;Username=;Password=;Database=mydb";
        using var connection = new NpgsqlConnection(connectionString);
        try
        {
            connection.Open();
            Console.WriteLine("Connected to PostgreSQL database!");
            // Perform database operations here...
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
        finally
        {
            connection.Close();
        }
    }
}

using Npgsql;
using System;

class Program
{
    static void Main(string [] args)
    {
        var connectionString = "Host=myhost;Username=;Password=;Database=mydb";
        using var connection = new NpgsqlConnection(connectionString);
        try
        {
            connection.Open();
            Console.WriteLine("Connected to PostgreSQL database!");
            // Perform database operations here...
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
        finally
        {
            connection.Close();
        }
    }
}

Imports Npgsql
Imports System

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim connectionString = "Host=myhost;Username=;Password=;Database=mydb"
		Dim connection = New NpgsqlConnection(connectionString)
		Try
			connection.Open()
			Console.WriteLine("Connected to PostgreSQL database!")
			' Perform database operations here...
		Catch ex As Exception
			Console.WriteLine($"Error: {ex.Message}")
		Finally
			connection.Close()
		End Try
	End Sub
End Class

VB C#

替換連接字串值 (主機, 使用者名稱, 密碼, 資料庫) 將資訊替換為您的 PostgreSQL 伺服器資訊。您可以使用 Npgsql 的命令執行功能在 try 區塊中運行 SQL 命令、查詢或其他數據庫操作。

Npgsql 是 .NET 開發人員在使用 PostgreSQL 時的流行選擇，因為它提供了廣泛的功能和連接 PostgreSQL 數據庫的方式。在您的應用程式代碼中，請務必有效處理連接、異常和其他錯誤情況。

Npgsql 與 IronPDF

IronPDF 擅长于其 HTML 轉 PDF 函數，確保所有佈局和樣式都被保留。它將網頁內容轉換成 PDF，適用於報告、發票和文檔。HTML 文件、URL 和 HTML 字串都可以輕鬆地轉換為 PDF。

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

Imports IronPdf

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim renderer = New ChromePdfRenderer()

		' 1. Convert HTML String to PDF
		Dim htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>"
		Dim pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent)
		pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf")

		' 2. Convert HTML File to PDF
		Dim htmlFilePath = "path_to_your_html_file.html" ' Specify the path to your HTML file
		Dim pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath)
		pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf")

		' 3. Convert URL to PDF
		Dim url = "http://ironpdf.com" ' Specify the URL
		Dim pdfFromUrl = renderer.RenderUrlAsPdf(url)
		pdfFromUrl.SaveAs("URLToPDF.pdf")
	End Sub
End Class

VB C#

若要將 Npgsql 與 IronPDF 集成，請按照以下步驟操作：

安裝必要的 NuGet 套件：

    Install-Package Npgsql
    Install-Package IronPdf

在您的代碼中導入所需的命名空間：

    using Npgsql;
    using IronPdf;

    using Npgsql;
    using IronPdf;

Imports Npgsql
	Imports IronPdf

VB C#

建立 Npgsql 連接並從 PostgreSQL 數據庫檢索數據：

    string connectionString = "Host=myhost;Username=myuser;Password=mypassword;Database=mydb";
    string query = "SELECT * FROM mytable";

    using (NpgsqlConnection connection = new NpgsqlConnection(connectionString))
    {
        connection.Open();

        using (NpgsqlCommand command = new NpgsqlCommand(query, connection))
        {
            NpgsqlDataReader dataReader = command.ExecuteReader();

            if (dataReader.HasRows)
            {
                while (dataReader.Read())
                {
                    // Process each row of data here
                }
            }

            dataReader.Close();
        }

        connection.Close();
    }

    string connectionString = "Host=myhost;Username=myuser;Password=mypassword;Database=mydb";
    string query = "SELECT * FROM mytable";

    using (NpgsqlConnection connection = new NpgsqlConnection(connectionString))
    {
        connection.Open();

        using (NpgsqlCommand command = new NpgsqlCommand(query, connection))
        {
            NpgsqlDataReader dataReader = command.ExecuteReader();

            if (dataReader.HasRows)
            {
                while (dataReader.Read())
                {
                    // Process each row of data here
                }
            }

            dataReader.Close();
        }

        connection.Close();
    }

IRON VB CONVERTER ERROR developers@ironsoftware.com

VB C#

使用 IronPDF 根據檢索到的數據生成 PDF 文件：

    HtmlToPdf Renderer = new HtmlToPdf();
    HtmlDocument Html = new HtmlDocument("<html><body><h1>My Data</h1></body></html>");

    PdfDocument PDF = Renderer.RenderHtmlAsPdf(Html);

    PDF.SaveAs("result.pdf");

    HtmlToPdf Renderer = new HtmlToPdf();
    HtmlDocument Html = new HtmlDocument("<html><body><h1>My Data</h1></body></html>");

    PdfDocument PDF = Renderer.RenderHtmlAsPdf(Html);

    PDF.SaveAs("result.pdf");

Dim Renderer As New HtmlToPdf()
	Dim Html As New HtmlDocument("<html><body><h1>My Data</h1></body></html>")

	Dim PDF As PdfDocument = Renderer.RenderHtmlAsPdf(Html)

	PDF.SaveAs("result.pdf")

VB C#

請注意，您需要根據您的具體需求和數據庫架構來自定義代碼。

通過以下步驟，您可以結合Npgsql和IronPDF的功能，從PostgreSQL數據庫檢索數據並根據這些數據生成PDF文檔。

安裝 IronPDF 庫

使用 NuGet 软件包管理器进行安装

要通过 NuGet 软件包管理器将 IronPDF 集成到您的 NpgSQL C# 项目中，请按照以下步骤操作：

打开 Visual Studio，在解决方案资源管理器中右键点击您的项目。
从上下文菜单中选择“管理 NuGet 软件包…”。
转到浏览选项卡并搜索 IronPDF。
从搜索结果中选择 IronPDF 库并点击安装按钮。
接受任何许可协议提示。

如果您希望通过软件包管理器控制台将 IronPDF 包含到您的项目中，请在软件包管理器控制台中执行以下命令：

Install-Package IronPdf

這將會將 IronPDF 取回並安裝到您的專案中。

使用 NuGet 網站進行安裝

如需 IronPDF 的詳細概述，包括其功能、相容性和其他下載選項，請訪問 NuGet 網站上的 IronPDF 頁面：https://www.nuget.org/packages/IronPdf。

透過 DLL 安裝

另外，您也可以將 IronPDF 直接納入您的專案中，使用其 DLL 檔案。從此處下載包含該 DLL 的 ZIP 檔案。連結解壓縮並將DLL包含在您的專案中。

使用 IronPDF 與 Npgsql 數據

截至 2022 年 1 月，Npgsql 和 IronPDF 在 .NET 應用程式中有各種用途。Npgsql 是一個數據提供者，使 .NET 程式更容易連接到 PostgreSQL 數據庫，而 IronPDF 是一個用於生成、修改和顯示 PDF 文件的 C# 庫。

由於 Npgsql 和 IronPDF 在 .NET 環境中提供單獨的功能，因此兩者之間沒有直接關聯或依賴。不過，在單個應用程式中同時使用這兩個庫是很常見的——IronPDF 用於 PDF 生成或操作，而 Npgsql 用於數據庫操作。

以下是如何在 C# 應用程式中使用 IronPDF 進行 PDF 創建和 Npgsql 進行數據庫操作的示例：

using IronPdf;
using Npgsql;
using System;
using System.Text;

class Program
{
    static async Task Main(string [] args)
    {
        StringBuilder sb = new StringBuilder();
        var connectionString = "Host=myhost;Username=myuser;Password=mypassword;Database=mydb";

        // Connecting to PostgreSQL using Npgsql
        await using var connection = new NpgsqlConnection(connectionString);
        try
        {
            await connection.OpenAsync();
            Console.WriteLine("Connected to PostgreSQL!");

            // Execute a database query using Npgsql
            await using var cmd = new NpgsqlCommand("SELECT username FROM my_table WHERE userid='005'", connection);
            await using var reader = await cmd.ExecuteReaderAsync();

            while (await reader.ReadAsync())
            {
                // Process database query results
                sb.Append(reader.GetString(0));
            }

            // Generate a PDF document using IronPDF
            var Renderer = new IronPdf.HtmlToPdf();
            var PDF = Renderer.RenderHtmlAsPdf($"<h1>Hello, {sb.ToString()}</h1>");
            PDF.SaveAs("Output.pdf");

            Console.WriteLine("PDF generated successfully.");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
        finally
        {
            connection.Close();
        }
    }
}

using IronPdf;
using Npgsql;
using System;
using System.Text;

class Program
{
    static async Task Main(string [] args)
    {
        StringBuilder sb = new StringBuilder();
        var connectionString = "Host=myhost;Username=myuser;Password=mypassword;Database=mydb";

        // Connecting to PostgreSQL using Npgsql
        await using var connection = new NpgsqlConnection(connectionString);
        try
        {
            await connection.OpenAsync();
            Console.WriteLine("Connected to PostgreSQL!");

            // Execute a database query using Npgsql
            await using var cmd = new NpgsqlCommand("SELECT username FROM my_table WHERE userid='005'", connection);
            await using var reader = await cmd.ExecuteReaderAsync();

            while (await reader.ReadAsync())
            {
                // Process database query results
                sb.Append(reader.GetString(0));
            }

            // Generate a PDF document using IronPDF
            var Renderer = new IronPdf.HtmlToPdf();
            var PDF = Renderer.RenderHtmlAsPdf($"<h1>Hello, {sb.ToString()}</h1>");
            PDF.SaveAs("Output.pdf");

            Console.WriteLine("PDF generated successfully.");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
        finally
        {
            connection.Close();
        }
    }
}

Imports IronPdf
Imports Npgsql
Imports System
Imports System.Text

Friend Class Program
	Shared Async Function Main(ByVal args() As String) As Task
		Dim sb As New StringBuilder()
		Dim connectionString = "Host=myhost;Username=myuser;Password=mypassword;Database=mydb"

		' Connecting to PostgreSQL using Npgsql
		Await var connection = New NpgsqlConnection(connectionString)
		Try
			Await connection.OpenAsync()
			Console.WriteLine("Connected to PostgreSQL!")

			' Execute a database query using Npgsql
			Await var cmd = New NpgsqlCommand("SELECT username FROM my_table WHERE userid='005'", connection)
			Await var reader = Await cmd.ExecuteReaderAsync()

			Do While Await reader.ReadAsync()
				' Process database query results
				sb.Append(reader.GetString(0))
			Loop

			' Generate a PDF document using IronPDF
			Dim Renderer = New IronPdf.HtmlToPdf()
			Dim PDF = Renderer.RenderHtmlAsPdf($"<h1>Hello, {sb.ToString()}</h1>")
			PDF.SaveAs("Output.pdf")

			Console.WriteLine("PDF generated successfully.")
		Catch ex As Exception
			Console.WriteLine($"Error: {ex.Message}")
		Finally
			connection.Close()
		End Try
	End Function
End Class

VB C#

這個範例展示了一個使用 IronPDF 創建基本 PDF 文件並使用 Npgsql 連接到 PostgreSQL 資料庫並運行範例查詢的情境。通過將這兩個庫納入他們的 C# 應用程序中，開發人員可以在同一代碼庫內獨立管理資料庫互動和文件製作。

請記得自定義代碼以適應您獨特的資料庫查詢、PDF 製作需求、錯誤處理和使用 Npgsql 和 IronPDF 的應用程序特定最佳實踐。有關 IronPDF 庫的更多信息，請訪問文檔頁面。