.NET 帮助

Npgsql C#（开发人员工作原理）

发布 2024年四月29日

Npgsql是实现 .NET 应用程序与.NET 应用程序之间顺畅通信的关键技术。PostgreSQL由于开发人员正在寻找使用数据库的强大方法，因此我们需要对.NET、Java、Python 或 Node js 数据库进行翻译。 PostgreSQL 服务器的 .NET 数据提供程序或 Npgsql 是数据库连接领域中创造性、有效性和适应性的象征。它允许 C#、Visual Basic 和 F# 用户访问数据库。还为 EF Core 用户提供了传统实体框架 6.x。

一个名为IronPDF在 C# 和 VB.NET 程序中用于生成、修改和显示 PDF 文档。除了执行复杂的任务（如合并多个 PDF、添加水印以及从已有的 PDF 文件中提取文本或图像）外，它还能让开发人员从各种来源（包括 HTML、照片和原始文本）创建 PDF 文件。

您将学习如何集成IronPDF和NPGSQL请按照本教程在 C# 应用程序中使用。我们将研究如何将这些工具结合起来，以改进应用程序的功能，从简单的设置到复杂的功能。

如何使用 Npgsql

创建一个新的 C# 项目
安装 Npgsql 库。
连接到 Npgsql 数据库。
执行查询并获取结果。
处理结果并关闭连接。

1.Npgsql 简介

基础知识、NpgsqlPostgreSQL 是一种开源关系数据库管理系统，以其稳定性、可扩展性和可扩展性而著称。 Npgsql 通过提供广泛的功能集，为开发人员提供了处理事务、进行查询、检索数据和简化数据库操作的能力，具有无与伦比的便利性和效率。

1.1 使用 Npgsql 的优势

性能：Npgsql 的速度和效率是内置的。为了保证在使用 PostgreSQL 数据库时达到最佳速度，它使用了批处理命令、异步输入/输出和优化数据类型等功能。

全面支持 PostgreSQL： Npgsql 的目标是全面支持 PostgreSQL 的所有功能，如数组、JSONB、高级数据类型和用户自定义类型。这意味着程序员可以在其.NET应用程序中充分利用PostgreSQL的全部潜力。

1.2 Npgsql 入门

1.2.1 在 C# 项目中设置 Npgsql

将 Npgsql 融入 C# 项目非常简单。添加 Npgsql 需要使用微软的 .NET 软件包管理 NuGet。该库提供将 PostgreSQL 数据库与 Npgsql 集成到您的项目中所需的工具和库。

Npgsql C#（如何为开发人员工作）：图 1 - 使用管理 NuGet Package for Solution 安装 Npgsql，方法是在 NuGet Package Manager 的搜索栏中搜索 Npgsql，然后选择项目并点击安装按钮。

1.2.2 在 Windows 控制台和窗体中实施 Npgsql

几种 C# 应用程序类型，如 Windows 窗体(WinForms)Npgsql 和 Windows 控制台可以使用 Npgsql。虽然每个框架的实现方式各不相同，但基本理念始终如一：Npgsql 是应用程序内部数据库的容器。

1.2.3 从 Npgsql 获取数据的基本示例

在使用 PostgreSQL 数据库之前，请先创建与 Npgsql 的连接。然后，运行 SQL 查询从 PostgreSQL 中获取数据。 NpgsqlCommand 是运行 SQL 查询的工具。

using Npgsql;
using System.Text;
class Program
{
    static void Main(string[] args)
    {
        // PostgreSQL connection string
        string connString = "Host=myServerAddress;Port=myPort;Username=myUsername;Password=myPassword;Database=myDatabase";
        // Create connection object
        NpgsqlConnection conn = new NpgsqlConnection(connString);
        // Open the connection
        conn.Open();
        // SQL query
        string sql = "SELECT * FROM myTable";
        // Create NpgsqlCommand
        NpgsqlCommand cmd = new NpgsqlCommand(sql, conn);
        // Execute the command and retrieve data
        NpgsqlDataReader reader = cmd.ExecuteReader();
        // 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"]);
            // Add data to the PDF
            Console.WriteLine($"Name: {name}, Age: {age}");
        }
        // Close the connection when done
        conn.Close();
    }
}

using Npgsql;
using System.Text;
class Program
{
    static void Main(string[] args)
    {
        // PostgreSQL connection string
        string connString = "Host=myServerAddress;Port=myPort;Username=myUsername;Password=myPassword;Database=myDatabase";
        // Create connection object
        NpgsqlConnection conn = new NpgsqlConnection(connString);
        // Open the connection
        conn.Open();
        // SQL query
        string sql = "SELECT * FROM myTable";
        // Create NpgsqlCommand
        NpgsqlCommand cmd = new NpgsqlCommand(sql, conn);
        // Execute the command and retrieve data
        NpgsqlDataReader reader = cmd.ExecuteReader();
        // 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"]);
            // Add data to the PDF
            Console.WriteLine($"Name: {name}, Age: {age}");
        }
        // Close the connection when done
        conn.Close();
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

VB C#

在上述代码片段中，我们从 Npgsql 获取数据并将其显示在控制台中。下图显示了执行查询的结果。

Npgsql C#（如何为开发人员工作）：图 2 - 在 .NET 项目中使用 Npgsql 软件包从 PostgreSQL 数据库显示姓名和年龄的控制台输出。

2.使用 PostgreSQL 进行 Npgsql 操作

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

Dim conn As New NpgsqlConnection(connString)

VB C#

这段基本代码可以帮助我们连接 PostgreSQL 数据库服务器。

3.将 Npgsql 与 IronPDF 集成

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 Package Manager for Solutions 安装 IronPdf。
- 在搜索结果中找到 IronPdf 软件包，选择它，然后点击 "安装 "按钮。 Visual Studio 将自动处理下载和安装。
IronPdf 软件包将连同您的项目所需的任何依赖项一起由 NuGet 下载并安装。
安装完成后，您就可以开始在项目中使用 IronPDF 了。

通过 NuGet 网站安装

有关 IronPDF 的更多信息，包括功能、兼容性和其他下载选择，请访问NuGet 上的 IronPDF 软件包网站。

利用 DLL 进行安装

作为替代方案，您可以使用 IronPdf 的 DLL 文件将其直接集成到您的项目中。使用此IronPDF ZIP 包链接可下载包含 DLL 的 ZIP 文件。解压缩后，将 DLL 添加到您的项目中。

实现逻辑

当我们开始运行应用程序时，它会使用 Npgsql .NET 库从数据库中获取数据。在 IronPDF 的帮助下，我们能够将数据库内容转换成 PDF 文档。

获取数据：当用户开始转换时，从 Npgsql .NET 提供程序中获取最新内容。
用 IronPDF 生成 PDF：要将 Npgsql 数据库中的数据转换成 PDF，请使用 IronPDF。可以使用 HtmlToPdf 类将 HTML 字符串格式化为 PDF 文档。
保存 PDF 和通知：将生成的 PDF 保存到指定位置或在控制台上留下一条可见信息。保存 PDF 文件后，通过终端消息通知用户转换成功。

using Npgsql;
using IronPdf;
using System.Text;
class Program
{
    static void Main(string[] args)
    {
        StringBuilder sb = new StringBuilder();
        var Renderer = new ChromePdfRenderer(); // Instantiates Chrome Renderer
        sb.Append("<h1>Dynamic PDF Generated from PostgreSQL Data</h1>");
        // Npgsql code here
        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>");
        }
        var pdf = Renderer.RenderHtmlAsPdf(sb.ToString());
        // Save the PDF document
        pdf.SaveAs("output.pdf");
        // Close the connection when done
        conn.Close();
    }
}

using Npgsql;
using IronPdf;
using System.Text;
class Program
{
    static void Main(string[] args)
    {
        StringBuilder sb = new StringBuilder();
        var Renderer = new ChromePdfRenderer(); // Instantiates Chrome Renderer
        sb.Append("<h1>Dynamic PDF Generated from PostgreSQL Data</h1>");
        // Npgsql code here
        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>");
        }
        var pdf = Renderer.RenderHtmlAsPdf(sb.ToString());
        // Save the PDF document
        pdf.SaveAs("output.pdf");
        // Close the connection when done
        conn.Close();
    }
}

Imports Npgsql
Imports IronPdf
Imports System.Text
Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim sb As New StringBuilder()
		Dim Renderer = New ChromePdfRenderer() ' Instantiates Chrome Renderer
		sb.Append("<h1>Dynamic PDF Generated from PostgreSQL Data</h1>")
		' Npgsql code here
		Do While Await reader.ReadAsync()
			' Retrieve data from the data reader
			Dim name As String = reader("Name").ToString()
			Dim age As Integer = Convert.ToInt32(reader("Age"))
			' Add data to the PDF
			sb.Append($"<p>Name: {name}, Age: {age}</p>")
		Loop
		Dim pdf = Renderer.RenderHtmlAsPdf(sb.ToString())
		' Save the PDF document
		pdf.SaveAs("output.pdf")
		' Close the connection when done
		conn.Close()
	End Sub
End Class

VB C#

以下是上述代码生成的结果。欲了解更多关于IronPDF 文档参考指南。

Npgsql C#（如何为开发人员工作）：图 4 - 使用 Npgsql PostgreSQL 数据库和 IronPDF 生成的 PDF 输出。