1. IronPDF
  2. IronPDF 部落格
  3. .NET 幫助
  4. NBuilder .NET
.NET 幫助

NBuilder .NET（其工作原理對開發者）

Chipego
奇佩戈·卡林达
2024年8月13日
分享:

NBuilder 是一個.NET 函式庫，用於簡化測試資料的生成。 開發人員可以利用其流暢的介面輕鬆地創建複雜的物件圖。 它提供靈活性、高效率以及與熱門測試框架的無縫整合。 在本文中，我們將探索NBuilder的功能、如何安裝它，並通過實際的代碼示例展示其能力。

NBuilder .NET（它如何為開發人員提供功能）：圖1 - NBuilder

NBuilder 的功能

  1. NBuilder 是一個 C# 開源 .NET 函式庫，旨在簡化物件的建立，以用於測試和模擬目的。 它允許開發人員根據不同的資料類型快速生成具有預設或自訂輸入的物件。

  2. 它特別適用於單元測試、功能測試和整合測試。

  3. 這是測試內建 .NET 資料類型和複雜對象的基本套件之一。

  4. 它用於隨機數據生成。 您可以為這個開源專案作出貢獻。

  5. 使用 NBuilder，您可以輕鬆地覆蓋預設屬性並編寫自訂配置。

安裝 NBuilder

要在 NuGet 套件管理器控制台中安裝 NBuilder，請使用以下命令。

Install-Package Nbuilder
Install-Package Nbuilder
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

上面的指令將安裝 NBuilder 及其所有相依項目。

NBuilder .NET（對開發人員的工作原理）：圖 2 - 安裝 NBuilder

NBuilder 的使用

NBuilder 提供了一種流暢的方式來即時創建對象。 讓我們從創建一個物件的簡單例子開始。

以下是Person模型類別的原始碼。

class Person
    {
        public int Id { get; set; }
        public string Name { get; set; }
        public string Email { get; set; }
        public bool IsMarried { get; set; }
    }
class Person
    {
        public int Id { get; set; }
        public string Name { get; set; }
        public string Email { get; set; }
        public bool IsMarried { get; set; }
    }
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

範例 1：使用預設值創建一個 Person 物件

var person = Builder<Person>
                .CreateNew()
                .Build();
// person = { Id = 1, Name = Name1, Email = Email1 , IsMarried  = false }
var person = Builder<Person>
                .CreateNew()
                .Build();
// person = { Id = 1, Name = Name1, Email = Email1 , IsMarried  = false }
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

範例圖片

NBuilder .NET（開發者如何使用）：圖 3 - 擁有值的 Person 物件

範例 2：使用自定義生成器創建物件

以下是如何使用 NBuilder 創建並配置帶有自定義屬性的 Person 物件的示例：

var customPersonBuilder = Builder<Person>.CreateNew()
                .With(p => p.Name = "Tom")
                .With(p => p.Email = "Tom@email.com");
var objTom = customPersonBuilder.Build();
var customPersonBuilder = Builder<Person>.CreateNew()
                .With(p => p.Name = "Tom")
                .With(p => p.Email = "Tom@email.com");
var objTom = customPersonBuilder.Build();
Dim customPersonBuilder = Builder(Of Person).CreateNew().With(Sub(p) p.Name = "Tom").With(Sub(p) p.Email = "Tom@email.com")
Dim objTom = customPersonBuilder.Build()
$vbLabelText   $csharpLabel

上述程式碼建立了一個具有自定屬性的 Person 對象。 它初始化了一個自訂 customPersonBuilder 用於 Person 物件，將名字設為 "Tom" 並將電子郵件設為 "Tom@email.com"。 最後，它會構建對象並將其分配給 objTom。

範例 3：使用預設值建立人員物件列表

var personList = Builder<Person>
                                     .CreateListOfSize(10)
                                     .Build();
var personList = Builder<Person>
                                     .CreateListOfSize(10)
                                     .Build();
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

範例圖片

NBuilder .NET（對開發者的運作方式）：圖 4 - 人物對象列表

這裡的 personList 有 10 個物件及其預設值並將它們打印出來。

var personList = Builder<Person>
                                            .CreateListOfSize(10)
                                            .Build();
// Here it creates the 10 objects of Person in personList
foreach (var person in personList)
{
    Console.WriteLine($"{person.Id}, {person.Name}, {person.Email}, {person.IsMarried}, ");
}
var personList = Builder<Person>
                                            .CreateListOfSize(10)
                                            .Build();
// Here it creates the 10 objects of Person in personList
foreach (var person in personList)
{
    Console.WriteLine($"{person.Id}, {person.Name}, {person.Email}, {person.IsMarried}, ");
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

NBuilder .NET（它如何為開發者工作）：圖 5 - 自動分配值

範例 4：自定義生成的對象

有時您可能需要自訂正在創建的對象。 您也可以使用 with() 方法來自訂物件的值。

var personList = Builder<Person>
                .CreateListOfSize(10)
                .All()
                .With(p => p.Name = "Kim")
                .With(p => p.Email = "abc@email.com")
                .With(p => p.IsMarried = false)
                .Build();
// Output:  
//    Id:  1, Name: Name1, Email: Email1, IsMarried False,
//    Id : 2, Name: Name2, Email: Email2, IsMarried True,
//    Id : 3, Name: Name3, Email: Email3, IsMarried False,
//    Id : 4, Name: Name4, Email: Email4, IsMarried True,
//    Id : 5, Name: Name5, Email: Email5, IsMarried False,
//    Id : 6, Name: Name6, Email: Email6, IsMarried True,
//    Id : 7, Name: Name7, Email: Email7, IsMarried False,
//    Id : 8, Name: Name8, Email: Email8, IsMarried True,
//    Id : 9, Name: Name9, Email: Email9, IsMarried False,
//    Id : 10, Name: Name10, Email: Email10, IsMarried True,
var personList = Builder<Person>
                .CreateListOfSize(10)
                .All()
                .With(p => p.Name = "Kim")
                .With(p => p.Email = "abc@email.com")
                .With(p => p.IsMarried = false)
                .Build();
// Output:  
//    Id:  1, Name: Name1, Email: Email1, IsMarried False,
//    Id : 2, Name: Name2, Email: Email2, IsMarried True,
//    Id : 3, Name: Name3, Email: Email3, IsMarried False,
//    Id : 4, Name: Name4, Email: Email4, IsMarried True,
//    Id : 5, Name: Name5, Email: Email5, IsMarried False,
//    Id : 6, Name: Name6, Email: Email6, IsMarried True,
//    Id : 7, Name: Name7, Email: Email7, IsMarried False,
//    Id : 8, Name: Name8, Email: Email8, IsMarried True,
//    Id : 9, Name: Name9, Email: Email9, IsMarried False,
//    Id : 10, Name: Name10, Email: Email10, IsMarried True,
Dim personList = Builder(Of Person) .CreateListOfSize(10).All().With(Sub(p) p.Name = "Kim").With(Sub(p) p.Email = "abc@email.com").With(Sub(p) p.IsMarried = False).Build()
' Output:  
'    Id:  1, Name: Name1, Email: Email1, IsMarried False,
'    Id : 2, Name: Name2, Email: Email2, IsMarried True,
'    Id : 3, Name: Name3, Email: Email3, IsMarried False,
'    Id : 4, Name: Name4, Email: Email4, IsMarried True,
'    Id : 5, Name: Name5, Email: Email5, IsMarried False,
'    Id : 6, Name: Name6, Email: Email6, IsMarried True,
'    Id : 7, Name: Name7, Email: Email7, IsMarried False,
'    Id : 8, Name: Name8, Email: Email8, IsMarried True,
'    Id : 9, Name: Name9, Email: Email9, IsMarried False,
'    Id : 10, Name: Name10, Email: Email10, IsMarried True,
$vbLabelText   $csharpLabel

這將創建一個 personList，默認值為 Name = “Kim”、Email = “abc@email.com”，以及 IsMarried = false。

範例 5: 使用現實隨機數據創建人員對象清單

為了在 Person List 中獲取逼真的數據值，您可以使用 Faker Library .NET 獲取數據的真實值。

var personList = Builder<Person>
                .CreateListOfSize(10)
                .All()
                .With(p => p.Name = Faker.Name.FullName())
                .With(p => p.Id = Faker.RandomNumber.Next(20, 60))
                .Build();
var personList = Builder<Person>
                .CreateListOfSize(10)
                .All()
                .With(p => p.Name = Faker.Name.FullName())
                .With(p => p.Id = Faker.RandomNumber.Next(20, 60))
                .Build();
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

範例 6：使用序列化資料建立 Person 物件列表

有時你可能需要生成具有連續數據的對象。 NBuilder .NET 使用 Do 方法來促成此點。

var personList = Builder<Person>.CreateListOfSize(10)
                .All()
                .Do((p, i) => p.Id = 501 + i)
                .Do((p, i) => p.Name = $"Person {i + 1}")
                .Build();
var personList = Builder<Person>.CreateListOfSize(10)
                .All()
                .Do((p, i) => p.Id = 501 + i)
                .Do((p, i) => p.Name = $"Person {i + 1}")
                .Build();
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

此處，All() 方法應用於後續操作以處理所有 10 個 person 對象並在記憶體中創建列表。 Do() 方法用於在每個 Person 物件上執行 Action Delegate。

在這個例子中，它將每個人指定的 Id 屬性設置為 501。Lambda 表達式 (p, i) 接受兩個參數：p 是人員，i 是該特定對象在列表中的索引，範圍從 (0 到 9)，因為該列表分別包含 10 個對象。 透過在 Id 屬性中添加 i 值，屬性將依次設定從 501 到 510，並且 Name 屬性將設定為 Person 1 到 Person 10。

NBuilder .NET (開發人員使用方法)：圖 6 - 序列數據

範例7：使用Xunit進行單元測試的NBuilder

NBuilder 在 .NET 中經常用於測試環境，開發人員需要生成真實且多樣化的數據集以進行測試。 它使測試變得簡單且易於維護，使用複雜的對象允許開發人員使用 lambda 表達式和委派函數定義自訂初始化邏輯，以滿足對高效且靈活的測試數據生成感興趣的人。

模型類和單元測試服務

class Person
    {
        public int Id { get; set; }
        public string Name { get; set; }
        public string Email { get; set; }
        public bool IsMarried { get; set; }
    }
class PersonService
    {
        public string GetPersonEmail(Person person)
        {
            return person.Email;
        }
    }
class Person
    {
        public int Id { get; set; }
        public string Name { get; set; }
        public string Email { get; set; }
        public bool IsMarried { get; set; }
    }
class PersonService
    {
        public string GetPersonEmail(Person person)
        {
            return person.Email;
        }
    }
Friend Class Person
		Public Property Id() As Integer
		Public Property Name() As String
		Public Property Email() As String
		Public Property IsMarried() As Boolean
End Class
Friend Class PersonService
		Public Function GetPersonEmail(ByVal person As Person) As String
			Return person.Email
		End Function
End Class
$vbLabelText   $csharpLabel

這裡，類別 Person 具有以下屬性，而 PersonService 僅有一個公共方法 GetPersonEmail()，該方法返回該特定物件的 Person 郵件。

測試類別和測試數據

public class PersonTests
{
     [Fact]
     public void GetPersonEmail_ReturnCorrectEmail()
     {
         // Arrange
         var service = new PersonService();
         string expectedEmail = "Tom@email.com";
         var person = Builder<Person>.CreateNew()
             .With(p => p.Name = "Tom")
             .With(p => p.Email "Tom@email.com")
             .Build();
         // Act
         var actualEmail = service.GetPersonEmailById(person);
         // Assert
         Assert.Equal(actualEmail, expectedEmail);
     }
}
public class PersonTests
{
     [Fact]
     public void GetPersonEmail_ReturnCorrectEmail()
     {
         // Arrange
         var service = new PersonService();
         string expectedEmail = "Tom@email.com";
         var person = Builder<Person>.CreateNew()
             .With(p => p.Name = "Tom")
             .With(p => p.Email "Tom@email.com")
             .Build();
         // Act
         var actualEmail = service.GetPersonEmailById(person);
         // Assert
         Assert.Equal(actualEmail, expectedEmail);
     }
}
Public Class PersonTests
	 <Fact>
	 Public Sub GetPersonEmail_ReturnCorrectEmail()
		 ' Arrange
		 Dim service = New PersonService()
		 Dim expectedEmail As String = "Tom@email.com"
		 Dim person = Builder(Of Person).CreateNew().With(Sub(p) p.Name = "Tom").With(Function(p) p.Email "Tom@email.com").Build()
		 ' Act
		 Dim actualEmail = service.GetPersonEmailById(person)
		 ' Assert
		 Assert.Equal(actualEmail, expectedEmail)
	 End Sub
End Class
$vbLabelText   $csharpLabel

該單元測試驗證了 PersonService 類的 GetPersonEmailById 方法是否正確返回具有預期電子郵件 "Tom@email.com" 的 Person 物件的電子郵件地址。 它使用安排-執行-斷言模式來設置測試數據，執行該方法，然後檢查實際結果是否符合預期結果。

將 NBuilder 與 IronPDF 整合

了解 IronPDF 是一個強大的 C# 程式庫，專為在 .NET 應用程式中從 HTML 創建 PDF而設計。 憑藉其直觀的 API，開發人員可以將 PDF 功能無縫整合到他們的項目中，無論是生成發票、報告還是互動表單。

NBuilder .NET（如何為開發人員工作）：圖 7 - IronPDF

安裝 IronPDF

開啟 NuGet 套件管理器主控台，並執行以下命令：

Install-Package IronPdf
Install-Package IronPdf
'INSTANT VB TODO TASK: The following line uses invalid syntax:
'Install-Package IronPdf
$vbLabelText   $csharpLabel

填充 5 個 Person 物件的列表

// Generating instances of the Person class with NBuilder
var people = Builder<Person>.CreateListOfSize(5).Build();
// Generating instances of the Person class with NBuilder
var people = Builder<Person>.CreateListOfSize(5).Build();
' Generating instances of the Person class with NBuilder
Dim people = Builder(Of Person).CreateListOfSize(5).Build()
$vbLabelText   $csharpLabel

使用 IronPDF 創建 PDF 文件

此代碼設置IronPDF授權密鑰並從Person對象列表生成HTML內容。

IronPdf.License.LicenseKey = "Your-License-Key";
var htmlContent = "<h1>Person List</h1>";
foreach (var person in people)
{
    htmlContent += $"<p>Id: {person.Id}, Name: {person.Name}, Email: {person.Email}, IsMarried: {person.IsMarried}</p>";
}
IronPdf.License.LicenseKey = "Your-License-Key";
var htmlContent = "<h1>Person List</h1>";
foreach (var person in people)
{
    htmlContent += $"<p>Id: {person.Id}, Name: {person.Name}, Email: {person.Email}, IsMarried: {person.IsMarried}</p>";
}
IronPdf.License.LicenseKey = "Your-License-Key"
Dim htmlContent = "<h1>Person List</h1>"
For Each person In people
	htmlContent &= $"<p>Id: {person.Id}, Name: {person.Name}, Email: {person.Email}, IsMarried: {person.IsMarried}</p>"
Next person
$vbLabelText   $csharpLabel

IronPdf.License.LicenseKey 使用特定的授權金鑰來啟用 IronPDF 的功能。

透過迭代 people 列表動態構建 HTML 內容，將每個 Person 對象的詳細信息（Id、Name、Email、IsMarried）附加到 HTML 結構中。

使用IronPDF在PDF文檔中渲染人員列表

此代碼使用IronPDF的ChromePdfRenderer將HTML內容轉換為PDF文件。

var renderer = new ChromePdfRenderer();
var pdfDoc = renderer.RenderHtmlAsPdf(htmlContent);
pdfDoc.SaveAs("PersonList.pdf");
var renderer = new ChromePdfRenderer();
var pdfDoc = renderer.RenderHtmlAsPdf(htmlContent);
pdfDoc.SaveAs("PersonList.pdf");
Dim renderer = New ChromePdfRenderer()
Dim pdfDoc = renderer.RenderHtmlAsPdf(htmlContent)
pdfDoc.SaveAs("PersonList.pdf")
$vbLabelText   $csharpLabel

ChromePdfRenderer 被實例化，用於將存儲在 htmlContent 中的 HTML 內容渲染成 PDF 文件。 生成的 PDF 文件將以 "PersonList.pdf" 的名稱保存到文件系統。

輸出

下面是由IronPDF生成的PersonList的輸出。 它包含五個人，每個人都有預設值。

NBuilder .NET（對開發人員的運作方式）：圖 8 - PDF 輸出

結論

總結而言，NBuilder 是一個強大且靈活的工具，用於在 .NET 中生成測試數據，簡化複雜對象圖的創建，並提高測試過程的效率。 透過與 IronPDF 整合，開發人員可以輕鬆擴展其應用程式，為那些認為對其專案有價值的人員包含PDF 生成功能。 NBuilder 和 IronPDF 共同配合可以顯著提升開發工作流程，使測試和文件生成順暢且高效。

Chipego
奇佩戈·卡林达
  立即與工程團隊聊天
軟體工程師
Chipego 擁有天生的傾聽技能，這幫助他理解客戶問題，並提供智能解決方案。他在獲得信息技術理學學士學位後，于 2023 年加入 Iron Software 團隊。IronPDF 和 IronOCR 是 Chipego 專注的兩個產品，但隨著他每天找到新的方法來支持客戶，他對所有產品的了解也在不斷增長。他喜歡在 Iron Software 的協作生活，公司內的團隊成員從各自不同的經歷中共同努力，創造出有效的創新解決方案。當 Chipego 離開辦公桌時，他常常享受讀好書或踢足球的樂趣。
< 上一頁
Refit C#（它如何為開發人員工作）
下一個 >
C# TryParse（開發者如何使用）
從NuGet 免費用於開發

安裝與 NuGet nuget.org/packages/IronPdf

PM > Install-Package IronPdf

報告問題

準備開始了嗎？ 版本： 2025.4 剛剛發布

免費開始
NuGet 下載 DLL 下載 Windows 安裝程式 開始免費試用
查看許可證 >
Textlogo Iron Suite related to NBuilder .NET（其工作原理對開發者）

IronPDF 是 IRON 的一部分套件

10 .NET API 產品適用於您的辦公文檔

以兩件產品的價格獲得十件產品   開始免費試用