.NET 幫助

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

Q: 你能解釋一下NHibernate中是如何執行CRUD操作的嗎？

NHibernate 中的 CRUD 操作透過 `ISession` 介面進行抽象，該介面提供了諸如 Save 、 Update 和 Delete 之類的方法。這使得開發人員無需直接編寫 SQL 命令即可執行這些操作。

Q: 如何在.NET專案中設定NHibernate？

若要設定 NHibernate，請使用指令 Install-Package NHibernate 透過 Visual Studio 的 NuGet 套件管理器安裝 NHibernate 套件。使用類似 `hibernate.cfg.xml` 的 XML 映射檔案對其進行配置，以定義資料庫設定和物件映射。

雅各·梅勒

更新:7月 28, 2025

NHibernate C# (How It Works For Developers)：圖 1 - NHibernate C# 的首頁。

NHibernate 是一個功能強大的物件關聯映射 (ORM) 框架，專為搭配 .NET Framework 使用而設計。它為開發人員提供了一種有效的方式，縮短 .NET 應用程式的物件導向世界與資料庫的關聯世界之間的距離。透過使用 NHibernate，您可以大幅減少實作資料存取層所需的模板程式碼，讓您的 .NET 應用程式更乾淨、更易維護。

ORM 在簡化資料庫互動中的作用

像 NHibernate 之類的 ORM 框架，透過允許開發人員以物件及其屬性而非 SQL 語句來處理資料，簡化了與關聯式資料庫的互動。這種抽象可以幫助開發人員更專注於應用程式的商業邏輯，而較少關注底層的 SQL 指令和資料庫架構。舉例來說，NHibernate 會處理所有 SQL 的產生和執行，讓插入、刪除和更新等作業可以透過簡單的物件轉換和物件操作來進行。

在 .NET 專案中設定 NHibernate

要在您的 .NET 專案中開始使用 NHibernate，第一步是安裝 NHibernate 套件。您可以透過 Visual Studio 的 NuGet Package Manager，使用下列指令輕鬆完成：

Install-Package NHibernate

NHibernate C# (How It Works For Developers)：圖 2 - 開啟命令列控制台並輸入上面的命令來安裝 NHibernate

使用 XML 配置文件配置 NHibernate

一旦安裝了 NHibernate，下一步就是設定它。這包括建立 Hibernate 對應檔，詳細說明您的資料庫伺服器設定，以及物件到資料庫表的對應細節。主 XML 檔案通常命名為 hibernate.cfg.xml 包含資料庫連線字串、方言和其他資料庫特定設定等設定。

<?xml version="1.0" encoding="utf-8" ?>
<hibernate-configuration xmlns="urn:nhibernate-configuration-2.2">
  <session-factory>
    <property name="connection.provider">
      NHibernate.Connection.DriverConnectionProvider
    </property>
    <property name="connection.driver_class">
      NHibernate.Driver.SqlClientDriver
    </property>
    <property name="connection.connection_string">
      Server=myServerAddress;Database=myDataBase;User Id=myUsername;Password=myPassword;
    </property>
    <property name="dialect">
      NHibernate.Dialect.MsSql2012Dialect
    </property>
    <property name="show_sql">true</property>
    <mapping resource="Employee.hbm.xml"/>
  </session-factory>
</hibernate-configuration>

<?xml version="1.0" encoding="utf-8" ?>
<hibernate-configuration xmlns="urn:nhibernate-configuration-2.2">
  <session-factory>
    <property name="connection.provider">
      NHibernate.Connection.DriverConnectionProvider
    </property>
    <property name="connection.driver_class">
      NHibernate.Driver.SqlClientDriver
    </property>
    <property name="connection.connection_string">
      Server=myServerAddress;Database=myDataBase;User Id=myUsername;Password=myPassword;
    </property>
    <property name="dialect">
      NHibernate.Dialect.MsSql2012Dialect
    </property>
    <property name="show_sql">true</property>
    <mapping resource="Employee.hbm.xml"/>
  </session-factory>
</hibernate-configuration>

XML

瞭解 NHibernate 的核心元件

NHibernate 的關鍵元件之一是 Session Factory，它是使用工廠設計模式來設計的。此元件會建立 Session 物件，以管理與資料庫的連線，並持有交易操作。 Session Factory 的建立成本很高，所以通常在每個應用程式生命週期中都會執行一次，因此是效能最佳化的重要元素。

NHibernate 中的關鍵類和方法

NHibernate 圍繞著幾個基本的類別和方法。舉例來說，ISession 介面在 NHibernate 中扮演基本的角色，有助於建立資料查詢和處理會話。像 OpenSession 之類的方法可以幫助開發人員啟動事務、執行 SQL 指令，並使用 SQL 語句或 NHibernate 自己的 HQL（Hibernate 查詢語言）來查詢資料庫。

使用 NHibernate 將實體映射到資料庫表

NHibernate 中的實體映射是透過映射檔案完成的，通常以 XML 撰寫。這些檔案通常以實體類命名（例如，Employee.hbm.xml），定義實體的屬性如何映射到資料庫表的欄位。典型的對應檔案包括類別名稱、表格名稱，以及每個屬性的詳細資訊，包括主索引鍵、欄位名稱和資料類型。

詳細瞭解映射檔案中使用的屬性和屬性。

在這些對應檔案中，您可以為每個屬性指定各種屬性，例如 not-null 約束或唯一約束。 NHibernate 也允許複雜的映射，例如一對多和多對一的關係，提供了一個強大的工具集，用來在物件導向的架構中表示關係資料結構。

在 NHibernate 中執行 SQL 指令和事務。

NHibernate 透過抽象底層 SQL 指令簡化 CRUD (建立、讀取、更新、刪除) 作業。開發人員無須撰寫明確的 SQL 程式碼即可執行這些作業，取而代之的是使用 ISession 介面所提供的方法。例如，若要在資料庫中新增一個實體，您只需建立一個新的物件實體、設定其屬性，並使用 ISession 的 Save 方法即可。

使用 `ITransaction 管理交易`。

NHibernate 中的事務是透過 ITransaction 介面來管理，以確保資料的完整性與一致性。使用 ISession 中的 BeginTransaction 方法，開發人員可以在將資料提交到資料庫之前確保所有作業都已成功完成，或者在出錯時進行回滾，從而保持資料的穩定性。

完整程式碼範例

本範例包括 NHibernate 配置和映射檔案的設定，並示範如何使用 NHibernate 執行建立、讀取、更新和刪除作業。

using NHibernate;
using NHibernate.Cfg;
using System;

// Define the Employee class with virtual properties
public class Employee
{
    public virtual int Id { get; set; }
    public virtual string FirstName { get; set; }
    public virtual string LastName { get; set; }
}

class Program
{
    private static ISessionFactory sessionFactory;

    static void Main()
    {
        // Initialize the SessionFactory using NHibernate configuration
        sessionFactory = new Configuration().Configure().BuildSessionFactory();

        // Perform database operations
        CreateEmployee();
        ReadEmployee(1);
        UpdateEmployee(1, "UpdatedName");
        DeleteEmployee(1);
    }

    static void CreateEmployee()
    {
        using (var session = sessionFactory.OpenSession())
        using (var transaction = session.BeginTransaction())
        {
            var newEmployee = new Employee
            {
                FirstName = "Iron",
                LastName = "Software"
            };
            session.Save(newEmployee); // Save the new Employee object to the database
            transaction.Commit(); // Commit the transaction to finalize the insertion
            Console.WriteLine("Employee created: " + newEmployee.Id);
        }
    }

    static void ReadEmployee(int id)
    {
        using (var session = sessionFactory.OpenSession())
        {
            // Retrieve the Employee object by its Id
            var employee = session.Get<Employee>(id);
            Console.WriteLine("Read Employee: " + employee.FirstName + " " + employee.LastName);
        }
    }

    static void UpdateEmployee(int id, string newFirstName)
    {
        using (var session = sessionFactory.OpenSession())
        using (var transaction = session.BeginTransaction())
        {
            // Get the Employee object by its Id
            var employee = session.Get<Employee>(id);
            employee.FirstName = newFirstName; // Update the employee's first name
            session.Update(employee); // Update the Employee object in the database
            transaction.Commit(); // Commit the transaction to save changes
            Console.WriteLine("Employee updated: " + employee.FirstName);
        }
    }

    static void DeleteEmployee(int id)
    {
        using (var session = sessionFactory.OpenSession())
        using (var transaction = session.BeginTransaction())
        {
            // Retrieve the Employee object to be deleted
            var employee = session.Get<Employee>(id);
            session.Delete(employee); // Delete the Employee from the database
            transaction.Commit(); // Commit the transaction to finalize the deletion
            Console.WriteLine("Employee deleted");
        }
    }
}

using NHibernate;
using NHibernate.Cfg;
using System;

// Define the Employee class with virtual properties
public class Employee
{
    public virtual int Id { get; set; }
    public virtual string FirstName { get; set; }
    public virtual string LastName { get; set; }
}

class Program
{
    private static ISessionFactory sessionFactory;

    static void Main()
    {
        // Initialize the SessionFactory using NHibernate configuration
        sessionFactory = new Configuration().Configure().BuildSessionFactory();

        // Perform database operations
        CreateEmployee();
        ReadEmployee(1);
        UpdateEmployee(1, "UpdatedName");
        DeleteEmployee(1);
    }

    static void CreateEmployee()
    {
        using (var session = sessionFactory.OpenSession())
        using (var transaction = session.BeginTransaction())
        {
            var newEmployee = new Employee
            {
                FirstName = "Iron",
                LastName = "Software"
            };
            session.Save(newEmployee); // Save the new Employee object to the database
            transaction.Commit(); // Commit the transaction to finalize the insertion
            Console.WriteLine("Employee created: " + newEmployee.Id);
        }
    }

    static void ReadEmployee(int id)
    {
        using (var session = sessionFactory.OpenSession())
        {
            // Retrieve the Employee object by its Id
            var employee = session.Get<Employee>(id);
            Console.WriteLine("Read Employee: " + employee.FirstName + " " + employee.LastName);
        }
    }

    static void UpdateEmployee(int id, string newFirstName)
    {
        using (var session = sessionFactory.OpenSession())
        using (var transaction = session.BeginTransaction())
        {
            // Get the Employee object by its Id
            var employee = session.Get<Employee>(id);
            employee.FirstName = newFirstName; // Update the employee's first name
            session.Update(employee); // Update the Employee object in the database
            transaction.Commit(); // Commit the transaction to save changes
            Console.WriteLine("Employee updated: " + employee.FirstName);
        }
    }

    static void DeleteEmployee(int id)
    {
        using (var session = sessionFactory.OpenSession())
        using (var transaction = session.BeginTransaction())
        {
            // Retrieve the Employee object to be deleted
            var employee = session.Get<Employee>(id);
            session.Delete(employee); // Delete the Employee from the database
            transaction.Commit(); // Commit the transaction to finalize the deletion
            Console.WriteLine("Employee deleted");
        }
    }
}

$vbLabelText $csharpLabel

資料庫可移植性與互操作性功能

NHibernate 的設計提供資料庫的可移植性。由於其方言配置，NHibernate 能夠適應大多數的 SQL 資料庫，只需對程式碼基做最小的變更。這表示您可以從 SQL Server 轉換到 MySQL 或 Oracle，而無需重寫資料存取層。

為各種資料庫系統（如 SQL Server）適配 NHibernate。

NHibernate 中的 XML 配置文件允許開發人員指定其資料庫系統特有的 SQL 方言。這使得 NHibernate 成為一個靈活的解決方案，可以輕鬆地與幾乎所有支援 SQL 的關聯式資料庫搭配使用，確保您的應用程式可以在不同的資料庫系統中移植。

使用 IronPDF 的 NHibernate。

NHibernate C# (How It Works For Developers)：圖 3 - IronPDF 的首頁。

整合 NHibernate 與 IronPDF 是一個強大的組合，可以增強您的 .NET 應用程式。它可以讓您使用 NHibernate 管理資料庫作業，同時利用 IronPDF 從資料產生 PDF 文件。考慮一種情況，您的應用程式需要提供使用者特定的文件，例如員工報告，這些文件需要以 PDF 格式產生和下載。 NHibernate 可以有效地管理資料庫的資料擷取程序，而 IronPDF 則可以將這些資料轉換成格式良好的 PDF 檔案。

安裝 IronPDF

首先，確保 IronPDF 已加入您的專案。您可以透過 NuGet Package Manager 安裝 IronPDF 套件來包含它。

Install-Package IronPdf

NHibernate C# (How It Works For Developers)：圖 4 - 透過 NuGet 套件管理員安裝 IronPdf

程式碼範例

讓我們深入探討如何在您的應用程式中實現這一點。在設定 NHibernate 並從資料庫擷取必要的資料（例如員工的詳細資料）之後，您將製作一個 HTML 模板，代表 PDF 文件應該如何顯示。此 HTML 模板可動態填入從 NHibernate 取得的資料。舉例來說，如果您要為某位員工製作報告，範本會包含員工姓名、ID 及其他相關詳細資料的占位符。

以下是一個詳細的程式碼範例，示範使用 NHibernate 取得資料，並使用 IronPDF 將資料轉換成 PDF：

using IronPdf;
using NHibernate;

static void CreateEmployeeReport(int employeeId)
{
    // Open a session to interact with the database
    using (var session = OpenSession())
    {
        // Retrieve the employee object based on the provided ID
        var employee = session.Get<Employee>(employeeId);

        // Create an instance of the ChromePdfRenderer class from IronPDF
        var renderer = new ChromePdfRenderer();

        // Create the HTML content for the PDF, embedding employee data into the HTML
        var htmlTemplate = $@"
            <html>
            <head>
                <title>Employee Report</title>
            </head>
            <body>
                <h1>Employee Details</h1>
                <p>Name: {employee.FirstName} {employee.LastName}</p>
                <p>ID: {employee.Id}</p>
            </body>
            </html>";

        // Render the HTML string as a PDF document
        var pdf = renderer.RenderHtmlAsPdf(htmlTemplate);

        // Save the generated PDF to a file
        pdf.SaveAs("EmployeeReport.pdf");
    }
}

using IronPdf;
using NHibernate;

static void CreateEmployeeReport(int employeeId)
{
    // Open a session to interact with the database
    using (var session = OpenSession())
    {
        // Retrieve the employee object based on the provided ID
        var employee = session.Get<Employee>(employeeId);

        // Create an instance of the ChromePdfRenderer class from IronPDF
        var renderer = new ChromePdfRenderer();

        // Create the HTML content for the PDF, embedding employee data into the HTML
        var htmlTemplate = $@"
            <html>
            <head>
                <title>Employee Report</title>
            </head>
            <body>
                <h1>Employee Details</h1>
                <p>Name: {employee.FirstName} {employee.LastName}</p>
                <p>ID: {employee.Id}</p>
            </body>
            </html>";

        // Render the HTML string as a PDF document
        var pdf = renderer.RenderHtmlAsPdf(htmlTemplate);

        // Save the generated PDF to a file
        pdf.SaveAs("EmployeeReport.pdf");
    }
}

$vbLabelText $csharpLabel

NHibernate C# (How It Works For Developers)：圖 5 - 上述程式碼的輸出範例

在此代碼中，OpenSession() 是一個初始化 NHibernate 會話的方法，用來取得員工資料。然後，IronPDF 的 ChromePdfRenderer 類會取得填入擷取資料的 HTML 模版，並將其渲染為 PDF。此 PDF 將儲存於本機，但也可以透過網頁介面直接串流給使用者。

結論

NHibernate C# (How It Works For Developers)：圖 6 - IronPDF 授權頁面。

在本教程中，我們探討了 NHibernate 如何簡化 .NET 應用程式中的資料庫操作，以及它與 IronPDF 的整合如何透過允許生成動態 PDF 文件來增強功能。 NHibernate 提供強大的資料管理工具，而 IronPDF 則提供方便的方式，讓您從填滿資料的 HTML 模版中建立專業品質的 PDF。

IronPdf 可供免費試用，而許可證的起始價格為具有成本效益的解決方案，可將強大的 PDF 生成功能整合到您的應用程式中。這些工具共同提供了管理資料和製作文件的全面解決方案，是企業級和小型專案的理想選擇。

常見問題解答

如何在 C# 中將 NHibernate 與 PDF 生成庫整合？

NHibernate 可以與 IronPDF 集成，NHibernate 用於處理資料庫操作和檢索數據，IronPDF 隨後可以將這些數據轉換為 PDF 文件。這使得基於用戶特定數據生成動態 PDF 成為可能。

NHibernate 中的 Session Factory 有什麼用途？

在 NHibernate 中，會話工廠是一個關鍵元件，它會建立會話物件來管理資料庫連線並執行事務操作。它透過增加創建成本來優化效能，並且通常每個應用程式生命週期只會實例化一次。

你能解釋一下NHibernate中是如何執行CRUD操作的嗎？

NHibernate 中的 CRUD 操作透過 `ISession` 介面進行抽象，該介面提供了諸如Save 、 Update和Delete之類的方法。這使得開發人員無需直接編寫 SQL 命令即可執行這些操作。

對於 .NET 開發人員來說，使用 NHibernate 有哪些好處？

NHibernate 透過減少資料存取層所需的樣板程式碼量，增強了應用程式的可維護性，從而使 .NET 開發人員受益。它還抽象化了資料庫交互，使開發人員能夠更專注於業務邏輯。

NHibernate 如何支援資料庫可攜性？

NHibernate 透過其方言配置支援資料庫可攜性，使其能夠適應各種 SQL 資料庫。這使得開發人員只需對程式碼庫進行極少的更改即可從一個資料庫系統切換到另一個資料庫系統。

NHibernate 中映射檔案的作用是什麼？

NHibernate 中的對應檔案（通常是 XML 檔案）定義了實體的屬性如何對應到資料庫表中的欄位。它們包含主鍵、列名和資料類型等重要細節，支援複雜的映射，例如一對多關係。

如何在 NHibernate 中有效地管理事務？

NHibernate 中的事務使用 `ITransaction` 介面進行管理，以確保資料完整性。開發人員可以使用 `ISession` 介面中的 ` BeginTransaction方法來處理操作，僅當所有操作都成功時才提交數據，如果出現任何問題則回滾。

如何在.NET專案中設定NHibernate？

若要設定 NHibernate，請使用指令Install-Package NHibernate透過 Visual Studio 的 NuGet 套件管理器安裝 NHibernate 套件。使用類似 `hibernate.cfg.xml` 的 XML 映射檔案對其進行配置，以定義資料庫設定和物件映射。

雅各·梅勒

現在就和工程團隊聊天吧

首席技術長

Jacob Mellor 是 Iron Software 的首席技術官，也是一位富有遠見的工程師，率先開發了 C# PDF 技術。作為 Iron Software 核心程式碼庫的最初開發者，他自公司成立之初便參與塑造了其產品架構，並與執行長 Cameron Rimington 一起將其發展成為一家擁有 50 多名員工、服務於 NASA、特斯拉和全球政府機構的公司。

Jacob 於 1998 年至 2001 年在曼徹斯特大學獲得土木工程一級榮譽學士學位。 1999 年，他在倫敦創辦了自己的第一家軟體公司；2005 年，他創建了自己的第一個 .NET 元件。此後，他專注於解決微軟生態系統中的複雜問題。

他的旗艦產品 IronPDF 和 IronSuite .NET 庫在全球 NuGet 上的安裝量已超過 3000 萬次，其基礎程式碼持續為全球開發者工具提供支援。憑藉 25 年的商業經驗和 41 年的程式設計專長，Jacob 始終致力於推動企業級 C#、Java 和 Python PDF 技術的創新，同時指導下一代技術領導者。

Ocelot .NET（開發者使用指南）

Rebus .NET Core 範例（開發者�...

客戶亮點：

開發者對焦：

網路研討會：

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

ORM 在簡化資料庫互動中的作用

在 .NET 專案中設定 NHibernate

使用 XML 配置文件配置 NHibernate

瞭解 NHibernate 的核心元件

NHibernate 中的關鍵類和方法

使用 NHibernate 將實體映射到資料庫表

詳細瞭解映射檔案中使用的屬性和屬性。

在 NHibernate 中執行 SQL 指令和事務。

使用 `ITransaction 管理交易`。

完整程式碼範例

資料庫可移植性與互操作性功能

為各種資料庫系統（如 SQL Server）適配 NHibernate。

使用 IronPDF 的 NHibernate。

安裝 IronPDF

程式碼範例

結論

常見問題解答

如何在 C# 中將 NHibernate 與 PDF 生成庫整合？

NHibernate 中的 Session Factory 有什麼用途？

你能解釋一下NHibernate中是如何執行CRUD操作的嗎？

對於 .NET 開發人員來說，使用 NHibernate 有哪些好處？

NHibernate 如何支援資料庫可攜性？

NHibernate 中映射檔案的作用是什麼？

如何在 NHibernate 中有效地管理事務？

如何在.NET專案中設定NHibernate？

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

ORM 在簡化資料庫互動中的作用

在 .NET 專案中設定 NHibernate

使用 XML 配置文件配置 NHibernate

瞭解 NHibernate 的核心元件

NHibernate 中的關鍵類和方法

使用 NHibernate 將實體映射到資料庫表

詳細瞭解映射檔案中使用的屬性和屬性。

在 NHibernate 中執行 SQL 指令和事務。

使用 ITransaction 管理交易。

完整程式碼範例

資料庫可移植性與互操作性功能

為各種資料庫系統（如 SQL Server）適配 NHibernate。

使用 IronPDF 的 NHibernate。

安裝 IronPDF

程式碼範例

結論

常見問題解答

如何在 C# 中將 NHibernate 與 PDF 生成庫整合？

NHibernate 中的 Session Factory 有什麼用途？

你能解釋一下NHibernate中是如何執行CRUD操作的嗎？

對於 .NET 開發人員來說，使用 NHibernate 有哪些好處？

NHibernate 如何支援資料庫可攜性？

NHibernate 中映射檔案的作用是什麼？

如何在 NHibernate 中有效地管理事務？

如何在.NET專案中設定NHibernate？

相關文章

連結 CLI 的簡潔性和 .NET：將 Curl DotNet 與 IronPDF 結合使用

C# 隨機數產生器

C# 字串相等運算子（開發者使用方法）

下一步：開始30天免費試用

下一步：開始30天免費試用

深受全球數百萬工程師信賴

使用 `ITransaction 管理交易`。