消息图标
跳至页脚内容
  1. IronPDF
  2. IronPDF博客
  3. .NET 帮助
  4. AutoFixture C#
.NET 帮助

AutoFixture C#（开发者用法）

Jacob Mellor，Team Iron 的首席技术官
Jacob Mellor
已更新:

AutoFixture 是一个开源库，旨在为 .NET 最小化单元测试书写中的'安排'阶段，从而改善测试管理。 其主要目的在于使开发者能够专注于他们正在测试的内容，而不是设置过程，通过让您使用测试数据创建对象图。 本文探讨了如何使用 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 实例。 然后，它断言 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 - 有效员工数据单元测试

IronPDF 简介

IronPDF C# PDF Library 是由 Iron Software 开发的强大 C# PDF 库，便于 读取 PDF 文本 和 使用 HTML 创建 PDF 文档。 这种多功能工具能够将易于格式化的文档（包括样式信息）转换为高质量的 PDF。 使用 IronPDF，从 HTML 文本生成 PDFs 是一个无缝过程，允许用户从 URL 中提取 HTML 内容，并将其转换为结构良好的 PDF 文件。 这一功能使得 IronPDF 成为开发人员希望直接从 Web 内容自动化和简化创建专业 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 中单元测试书写的'安排'阶段，为开发人员提供了一种专注于测试用例而不是设置细节的方法。 它简化了单元测试过程，通过自动生成测试数据确保多样化且真实的输入。 结合IronPDF 授权信息，提供了一个用于持续使用和支持的强大组合。

常见问题解答

如何使用AutoFixture在C#中生成测试数据？

您可以使用AutoFixture通过其“Fixture”类在C#中生成测试数据。该类允许您自动创建带有随机数据的类实例，这可以用于高效地设置各种测试场景。

AutoFixture在.NET项目中的安装步骤是什么？

要在.NET项目中安装AutoFixture，您可以使用NuGet包管理器控制台并运行命令Install-Package AutoFixture。也可以通过Visual Studio的NuGet包管理器UI搜索AutoFixture并将其添加到项目中。

AutoFixture如何改善单元测试过程？

AutoFixture通过自动生成现实且多样化的测试数据来增强单元测试过程。这减少了手动设置的需求，并确保测试在各种输入下进行，从而提高了测试覆盖率和可靠性。

AutoFixture可以与.NET中的PDF生成库集成吗？

可以，AutoFixture可以与如IronPDF这样的PDF生成库集成在.NET中。通过使用AutoFixture生成数据，您可以创建包含动态内容的PDF，例如员工数据，利用IronPDF将HTML转换为PDF的能力。

AutoFixture中‘Fixture’类的目的是什么？

AutoFixture中的‘Fixture’类旨在通过自动创建测试数据简化测试设置。它生成带有随机数据的类实例，使开发人员能更专注于测试逻辑而不是手动设置数据。

AutoFixture如何促进测试驱动开发（TDD）？

AutoFixture通过提供简便的方法生成测试数据来支持测试驱动开发（TDD），使开发者能够在不花费过多时间进行数据设置的情况下编写测试并实现功能，从而简化TDD过程，使其更高效。

如何在C#中使用AutoFixture和PDF库自动生成文档？

您可以通过结合AutoFixture和像IronPDF这样的PDF库来在C#中自动生成文档。AutoFixture可以生成文档所需的数据，而IronPDF可以高效地将格式化为HTML的数据转换为PDF文档。

Jacob Mellor，Team Iron 的首席技术官
Jacob Mellor
  立即与工程团队聊天
首席技术官

Jacob Mellor 是 Iron Software 的首席技术官，也是一位开创 C# PDF 技术的有远见的工程师。作为 Iron Software 核心代码库的原始开发者，他从公司成立之初就开始塑造公司的产品架构，与首席执行官 Cameron Rimington 一起将公司转变为一家拥有 50 多名员工的公司，为 NASA、特斯拉和全球政府机构提供服务。

Jacob 拥有曼彻斯特大学土木工程一级荣誉工程学士学位（BEng）（1998-2001 年）。他的旗舰产品 IronPDF 和 Iron Suite for .NET 库在全球的 NuGet 安装量已超过 3000 万次，其基础代码继续为全球使用的开发人员工具提供动力。Jacob 拥有 25 年的商业经验和 41 年的编码专业知识，他一直专注于推动企业级 C#、Java 和 Python PDF 技术的创新，同时指导下一代技术领导者。

相关文章

30天试用 → 完整产品。无限制。无卡。 免费试用

钢铁支援团队

我们每周 5 天，每天 24 小时在线。
聊天
电子邮件
打电话给我