信息圖標
跳過到頁腳內容
  1. IronPDF
  2. IronPDF博客
  3. .NET幫助
  4. AutoFixture C#
.NET幫助

AutoFixture C#（對開發者如何理解的工作）

Curtis Chau
Curtis Chau
更新日期:

AutoFixture is an open-source library for AutoFixture 是一個開源庫，旨在通過減少單元測試編寫的‘Arrange’階段來改善測試管理。 其主要目標是讓開發人員專注於他們正在測試的內容，而不是設置過程，通過讓您創建包含測試數據的對象圖。 本文探討了如何使用 AutoFixture 通過高效的測試數據生成來促進測試驅動開發。

AutoFixture 是 C# 中的一個強大庫，旨在簡化為單元測試創建測試數據的過程。 它幫助開發人員避免編寫重複的設置代碼，通過自動生成測試用例數據。 在單元測試中，AutoFixture 提供生成測試數據的流線型方法，確保每個單元測試都使用多樣且現實的輸入執行。 AutoFixture 使 C# 中的測試更加高效，通過自動生成測試數據，減少了手動設置的需求。

AutoFixture C# (如何為開發者工作): 圖 1 - AutoFixture

安裝和設置 AutoFixture

AutoFixture 可作為 NuGet 套件使用，並可以通過 NuGet 套件管理控制台或 Visual Studio 的 NuGet 套件管理器 UI 中的 .NET 添加套件進行安裝。

Install-Package AutoFixture

NuGet 將下載並安裝 AutoFixture 及其依賴項的最新版本到您的項目中。

為類創建測試數據的示例

假設我們有一個簡單的員工類，具有像 FirstName、LastName 和 Age 這樣的屬性。 在單元測試中，我們可以利用 AutoFixture 自動生成隨機數據，而不是手動創建該類的實例。

public class Employee
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public int Age { get; set; }

    public Employee(string firstName, string lastName, int age)
    {
        FirstName = firstName;
        LastName = lastName;
        Age = age;
    }

    public string GetFullName() => $"{FirstName} {LastName}";
}
public class Employee
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public int Age { get; set; }

    public Employee(string firstName, string lastName, int age)
    {
        FirstName = firstName;
        LastName = lastName;
        Age = age;
    }

    public string GetFullName() => $"{FirstName} {LastName}";
}
Public Class Employee
	Public Property FirstName() As String
	Public Property LastName() As String
	Public Property Age() As Integer

	Public Sub New(ByVal firstName As String, ByVal lastName As String, ByVal age As Integer)
		Me.FirstName = firstName
		Me.LastName = lastName
		Me.Age = age
	End Sub

	Public Function GetFullName() As String
		Return $"{FirstName} {LastName}"
	End Function
End Class
$vbLabelText   $csharpLabel

代碼描述

Employee 類封裝員工的基本信息，包括其名字、姓氏和年齡，這些都由屬性 FirstName、LastName 和 Age 表示。 其構造函數通過接受這些詳細信息並將它們分配給對應的屬性來促進員工對象的實例化。 此外，GetFullName 方法將員工的名字和姓氏連接在一起，將全名作為字符串返回。

為我們的測試場景設置代碼

接下來，我們將創建一個測試類來測試 Employee 類：

using AutoFixture;

public class EmployeeTests
{
    private readonly IFixture _fixture;

    public EmployeeTests()
    {
        // Using AutoFixture's Fixture to create test data
        _fixture = new Fixture();
    }
}
using AutoFixture;

public class EmployeeTests
{
    private readonly IFixture _fixture;

    public EmployeeTests()
    {
        // Using AutoFixture's Fixture to create test data
        _fixture = new Fixture();
    }
}
Imports AutoFixture

Public Class EmployeeTests
	Private ReadOnly _fixture As IFixture

	Public Sub New()
		' Using AutoFixture's Fixture to create test data
		_fixture = New Fixture()
	End Sub
End Class
$vbLabelText   $csharpLabel

代碼描述

此代碼片段將 AutoFixture 集成到 Employee 類的單元測試中。 通過導入 AutoFixture 命名空間，開發人員可以訪問數據生成功能。 _fixture 字段由一個新的 Fixture 實例初始化，簡化了測試數據的創建。 這種設置提高了測試效率和可靠性，為全面覆蓋 Employee 類提供便利。

示例 1：驗證員工測試案例對象值

[Fact]
public void Employee_ShouldHaveValidValues()
{
    // Arrange
    var firstName = _fixture.Create<string>();
    var lastName = _fixture.Create<string>();
    var age = _fixture.Create<int>();

    // Act
    var employee = new Employee(firstName, lastName, age);

    // Assert
    Assert.Equal(firstName, employee.FirstName);
    Assert.Equal(lastName, employee.LastName);
    Assert.Equal(age, employee.Age);
}
[Fact]
public void Employee_ShouldHaveValidValues()
{
    // Arrange
    var firstName = _fixture.Create<string>();
    var lastName = _fixture.Create<string>();
    var age = _fixture.Create<int>();

    // Act
    var employee = new Employee(firstName, lastName, age);

    // Assert
    Assert.Equal(firstName, employee.FirstName);
    Assert.Equal(lastName, employee.LastName);
    Assert.Equal(age, employee.Age);
}
<Fact>
Public Sub Employee_ShouldHaveValidValues()
	' Arrange
	Dim firstName = _fixture.Create(Of String)()
	Dim lastName = _fixture.Create(Of String)()
	Dim age = _fixture.Create(Of Integer)()

	' Act
	Dim employee As New Employee(firstName, lastName, age)

	' Assert
	Assert.Equal(firstName, employee.FirstName)
	Assert.Equal(lastName, employee.LastName)
	Assert.Equal(age, employee.Age)
End Sub
$vbLabelText   $csharpLabel

代碼描述

測試方法 Employee_ShouldHaveValidValues 驗證 Employee 類是否正確初始化其屬性並且設置提供的值。 使用測試夾具生成隨機數據的 FirstName、LastName 和 Age，然後創建一個 Employee 實例。 它接著證明 Employee 對象的 FirstName、LastName 和 Age 屬性能否匹配生成的數據，確保構造函數正確設置這些屬性。

示例 2：驗證當構造函數調用時的員工

[Fact]
public void CreateEmployee_ValidData_ReturnsEmployeeObject()
{
    // Arrange
    var employee = _fixture.Create<Employee>();

    // Act 
    // Assert
    Assert.NotNull(employee);
    Assert.False(string.IsNullOrEmpty(employee.FirstName));
    Assert.NotNull(employee.LastName);
    Assert.True(employee.Age > 0);
}
[Fact]
public void CreateEmployee_ValidData_ReturnsEmployeeObject()
{
    // Arrange
    var employee = _fixture.Create<Employee>();

    // Act 
    // Assert
    Assert.NotNull(employee);
    Assert.False(string.IsNullOrEmpty(employee.FirstName));
    Assert.NotNull(employee.LastName);
    Assert.True(employee.Age > 0);
}
<Fact>
Public Sub CreateEmployee_ValidData_ReturnsEmployeeObject()
	' Arrange
	Dim employee = _fixture.Create(Of Employee)()

	' Act 
	' Assert
	Assert.NotNull(employee)
	Assert.False(String.IsNullOrEmpty(employee.FirstName))
	Assert.NotNull(employee.LastName)
	Assert.True(employee.Age > 0)
End Sub
$vbLabelText   $csharpLabel

代碼描述

此測試方法包含的測試斷言驗證 Employee 對象的屬性與隨機生成的值是否匹配。 它驗證 string 類型屬性 FirstName 和 LastName和 int 類型的 Age 是否正確設置並有效。 任何失敗的斷言都表示預期的和隨機生成的員工詳細信息之間的數值不匹配。

AutoFixture C# (如何為開發者工作): 圖 2 - 有效的員工數據單元測試

Introducing IronPDF

IronPDF C# PDF Library is a robust C# PDF library developed by Iron Software that facilitates the reading of PDF text and the 讀取 PDF 文本 和使用 HTML 創建 PDF 文檔的過程。 這個多功能工具可以將帶有樣式信息的易於格式化文檔轉化為高質量的 PDF。 使用 IronPDF，從 HTML 文本生成 PDF 是一個無縫過程，允許使用者從 URL 中獲取 HTML 內容並將其轉換為結構良好的 PDF 文件。 這使得 IronPDF 成為開發人員希望直接從網頁內容自動創建專業 PDF 文檔的必需工具。

AutoFixture C# (如何為開發者工作): 圖 3 - IronPDF

安裝 IronPDF

打開 NuGet 套件管理控制台，運行以下命令：

Install-Package IronPdf

使用 AutoFixture 功能與 IronPDF 的代碼示例

以下是一個示例，演示了如何使用 AutoFixture 與 IronPDF 一起生成員工數據的 PDF：

using DemoAutofixture;
using IronPdf;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

public class EmployeePdfGenerator
{
    private readonly Fixture _fixture;

    public EmployeePdfGenerator()
    {
        _fixture = new Fixture();
    }

    public List<Employee> GenerateEmployees(int count)
    {
        return _fixture.CreateMany<Employee>(count).ToList();
    }

    public void GeneratePdf(List<Employee> employees, string filePath)
    {
        IronPdf.License.LicenseKey = "Your-License-Key-Here";
        var renderer = new ChromePdfRenderer();
        string htmlContent = GenerateHtml(employees);

        try
        {
            renderer.RenderHtmlAsPdf(htmlContent).SaveAs(filePath);
            Console.WriteLine("PDF Created Successfully!");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error generating PDF: {ex.Message}");
        }
    }

    private string GenerateHtml(List<Employee> employees)
    {
        StringBuilder htmlBuilder = new StringBuilder();
        htmlBuilder.Append("<!DOCTYPE html><html><head><title>Employee List</title></head><body><h1>Employee List</h1><ul>");

        foreach (var employee in employees)
        {
            htmlBuilder.Append($"<li>{employee.GetFullName()} - Age: {employee.Age}</li>");
        }

        htmlBuilder.Append("</ul></body></html>");
        return htmlBuilder.ToString();
    }
}
using DemoAutofixture;
using IronPdf;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

public class EmployeePdfGenerator
{
    private readonly Fixture _fixture;

    public EmployeePdfGenerator()
    {
        _fixture = new Fixture();
    }

    public List<Employee> GenerateEmployees(int count)
    {
        return _fixture.CreateMany<Employee>(count).ToList();
    }

    public void GeneratePdf(List<Employee> employees, string filePath)
    {
        IronPdf.License.LicenseKey = "Your-License-Key-Here";
        var renderer = new ChromePdfRenderer();
        string htmlContent = GenerateHtml(employees);

        try
        {
            renderer.RenderHtmlAsPdf(htmlContent).SaveAs(filePath);
            Console.WriteLine("PDF Created Successfully!");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error generating PDF: {ex.Message}");
        }
    }

    private string GenerateHtml(List<Employee> employees)
    {
        StringBuilder htmlBuilder = new StringBuilder();
        htmlBuilder.Append("<!DOCTYPE html><html><head><title>Employee List</title></head><body><h1>Employee List</h1><ul>");

        foreach (var employee in employees)
        {
            htmlBuilder.Append($"<li>{employee.GetFullName()} - Age: {employee.Age}</li>");
        }

        htmlBuilder.Append("</ul></body></html>");
        return htmlBuilder.ToString();
    }
}
Imports DemoAutofixture
Imports IronPdf
Imports System
Imports System.Collections.Generic
Imports System.Linq
Imports System.Text

Public Class EmployeePdfGenerator
	Private ReadOnly _fixture As Fixture

	Public Sub New()
		_fixture = New Fixture()
	End Sub

	Public Function GenerateEmployees(ByVal count As Integer) As List(Of Employee)
		Return _fixture.CreateMany(Of Employee)(count).ToList()
	End Function

	Public Sub GeneratePdf(ByVal employees As List(Of Employee), ByVal filePath As String)
		IronPdf.License.LicenseKey = "Your-License-Key-Here"
		Dim renderer = New ChromePdfRenderer()
		Dim htmlContent As String = GenerateHtml(employees)

		Try
			renderer.RenderHtmlAsPdf(htmlContent).SaveAs(filePath)
			Console.WriteLine("PDF Created Successfully!")
		Catch ex As Exception
			Console.WriteLine($"Error generating PDF: {ex.Message}")
		End Try
	End Sub

	Private Function GenerateHtml(ByVal employees As List(Of Employee)) As String
		Dim htmlBuilder As New StringBuilder()
		htmlBuilder.Append("<!DOCTYPE html><html><head><title>Employee List</title></head><body><h1>Employee List</h1><ul>")

		For Each employee In employees
			htmlBuilder.Append($"<li>{employee.GetFullName()} - Age: {employee.Age}</li>")
		Next employee

		htmlBuilder.Append("</ul></body></html>")
		Return htmlBuilder.ToString()
	End Function
End Class
$vbLabelText   $csharpLabel

要使用這個類，您需要實例化 EmployeePdfGenerator，生成一個員工列表，然後調用 GeneratePdf：

List<Employee> employees = new()
{
    new Employee("John", "Smith", 32),
    new Employee("Emily", "Davis", 18),
    new Employee("David", "Brown", 24),
    new Employee("Jane", "Doe", 16),
    new Employee("Michael", "Johnson", 49),
};

EmployeePdfGenerator pdfGenerator = new();
pdfGenerator.GeneratePdf(employees, "EmployeeList.pdf");
List<Employee> employees = new()
{
    new Employee("John", "Smith", 32),
    new Employee("Emily", "Davis", 18),
    new Employee("David", "Brown", 24),
    new Employee("Jane", "Doe", 16),
    new Employee("Michael", "Johnson", 49),
};

EmployeePdfGenerator pdfGenerator = new();
pdfGenerator.GeneratePdf(employees, "EmployeeList.pdf");
Dim employees As New List(Of Employee)() From {
	New Employee("John", "Smith", 32),
	New Employee("Emily", "Davis", 18),
	New Employee("David", "Brown", 24),
	New Employee("Jane", "Doe", 16),
	New Employee("Michael", "Johnson", 49)
}

Dim pdfGenerator As New EmployeePdfGenerator()
pdfGenerator.GeneratePdf(employees, "EmployeeList.pdf")
$vbLabelText   $csharpLabel

AutoFixture C# (如何為開發者工作): 圖 4 - AutoFixture 與 IronPDF 輸出

代碼描述

提供的 C# 代碼使用 IronPDF 庫生成一個列出員工和他們年齡的 PDF 文檔。 它定義了一個 EmployeePdfGenerator 類，其中包括 GeneratePdf 方法，它接收一個 Employee 對象列表和一個文件路徑。 內部，它通過 GenerateHtml 方法構建 HTML 內容，然後使用 IronPDF 的 HtmlToPdf 類將此 HTML 呈現為 PDF，並保存到指定的文件路徑。 改進包括使用 StringBuilder 進行 HTML 生成及為 PDF 生成和文件保存添加基本錯誤處理。

編寫測試方法

在下面的設置中，AutoFixture 用於創建 Employee 類的實例，從而生成隨機測試數據。 IronPDF 用於將包含員工信息的 HTML 內容無縫轉換為 PDF 格式。 EmployeePdfGenerator 類調度這些過程，效能良好管理數據生成和 PDF 轉換。 與此同時，EmployeePdfGeneratorTests XUnit 測試類通過嚴格的測試確保 PDF 生成功能的正常運行。 這種集成方法簡化了員工數據的生成和文檔製作，確保 PDF 生成過程的穩定性和可靠性。

using System.IO;
using Xunit;

public class EmployeePdfGeneratorTests
{
    [Fact]
    public void GeneratePdf_GeneratesPdfFile()
    {
        // Arrange
        var generator = new EmployeePdfGenerator();
        var employees = generator.GenerateEmployees(5);
        string filePath = "EmployeeList.pdf";

        // Act
        generator.GeneratePdf(employees, filePath);

        // Assert
        Assert.True(File.Exists(filePath));
    }
}
using System.IO;
using Xunit;

public class EmployeePdfGeneratorTests
{
    [Fact]
    public void GeneratePdf_GeneratesPdfFile()
    {
        // Arrange
        var generator = new EmployeePdfGenerator();
        var employees = generator.GenerateEmployees(5);
        string filePath = "EmployeeList.pdf";

        // Act
        generator.GeneratePdf(employees, filePath);

        // Assert
        Assert.True(File.Exists(filePath));
    }
}
Imports System.IO
Imports Xunit

Public Class EmployeePdfGeneratorTests
	<Fact>
	Public Sub GeneratePdf_GeneratesPdfFile()
		' Arrange
		Dim generator = New EmployeePdfGenerator()
		Dim employees = generator.GenerateEmployees(5)
		Dim filePath As String = "EmployeeList.pdf"

		' Act
		generator.GeneratePdf(employees, filePath)

		' Assert
		Assert.True(File.Exists(filePath))
	End Sub
End Class
$vbLabelText   $csharpLabel

在此，EmployeePdfGeneratorTests 類包含一個驗證測試案例，確保在指定的文件路徑正確創建 PDF 文件，驗證 GeneratePdf 方法的正確性。

AutoFixture C# (如何為開發者工作): 圖 5 - AutoFixture C#

結論

AutoFixture 簡化了 .NET unit 测试编写的‘Arrange’阶段，为开发人员提供了一种专注于测试用例而非设置复杂性的手段。 它简化了单元测试过程，确保通过自动生成测试数据提供多样化和现实的输入。 与 IronPDF 许可信息 结合使用，为持续使用和支持提供了强有力的组合。

常見問題解答

如何在 C# 中使用 AutoFixture 生成測試數據？

您可以通過使用 AutoFixture 的 'Fixture' 類來在 C# 中生成測試數據。這個類允許您自動創建帶有隨機數據的類實例，可以有效地設置各種測試場景。

AutoFixture 在 .NET 專案中的安裝步驟是什麼？

要在 .NET 專案中安裝 AutoFixture，您可以使用 NuGet 套件管理控制台並輸入命令 Install-Package AutoFixture。也可以通過 Visual Studio 的 NuGet 套件管理 UI 搜索並添加 AutoFixture 到您的專案中。

AutoFixture 如何改善單元測試過程？

AutoFixture 通過自動生成真實且多樣化的測試數據來增強單元測試過程。這減少了手動設置的需求，確保用於寬泛的輸入範圍進行測試，從而提高了測試覆蓋率和可靠性。

AutoFixture 能否與 .NET 中的 PDF 生成庫集成？

是的，AutoFixture 可以與像 IronPDF 這樣的 .NET 中的 PDF 生成庫集成。通過使用 AutoFixture 生成數據，您可以創建包含動態內容的 PDF，如員工數據，並利用 IronPDF 的功能將 HTML 轉換為 PDF。

AutoFixture 中 'Fixture' 類的目的是什麼？

'Fixture' 類設計用來簡化測試設置，通過自動創建測試數據。它生成帶有隨機數據的類實例，讓開發者更多地專注於測試邏輯，而不是手動設置數據。

AutoFixture 如何促進測試驅動開發 (TDD)？

AutoFixture 通過提供生成測試數據的簡便方法來輔助測試驅動開發 (TDD)，讓開發者可以在不花費大量時間設置數據的情況下撰寫測試和實現功能。這簡化了 TDD 過程，使其更為高效。

如何在 C# 中使用 AutoFixture 和 PDF 庫自動化文檔創建？

您可以通過結合 AutoFixture 和一個像 IronPDF 的 PDF 庫來在 C# 中自動化文檔創建。AutoFixture 可以生成文檔所需的數據，而 IronPDF 可以將這些格式為 HTML 的數據高效地轉換為 PDF 文檔。

Curtis Chau
Curtis Chau
  立即與工程團隊聊天
技術作家

Curtis Chau 擁有卡爾頓大學計算機科學學士學位，專注於前端開發，擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面，喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

除了開發之外，Curtis 對物聯網 (IoT) 有著濃厚的興趣，探索將硬體和軟體結合的創新方式。在閒暇時間，他喜愛遊戲並構建 Discord 機器人，結合科技與創意的樂趣。

相關文章

30 天試用→完整產品。無限制。無需信用卡。 開始免費試用