跳至页脚内容
  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}";
}
$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();
    }
}
$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);
}
$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);
}
$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();
    }
}
$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");
$vbLabelText   $csharpLabel

AutoFixture C# (开发人员运作)：图4 - AutoFixture 与 IronPDF 输出

代码描述

提供的 C# 代码使用 IronPDF 库生成列出员工及其年龄的 PDF 文档。 它定义了一个包含 GeneratePdf 方法的 EmployeePdfGenerator 类，该方法接受一个 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));
    }
}
$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 拥有曼彻斯特大学 (1998-2001) 的一级荣誉土木工程学士学位。1999 年在伦敦创办了自己的第一家软件公司，并于 2005 年创建了他的第一个 .NET 组件后，他专注于解决微软生态系统中的复杂问题。

他的旗舰 IronPDF 和 Iron Suite .NET 库在全球已获得超过 3000 万次的 NuGet 安装，其基础代码继续为全球使用的开发者工具提供支持。拥有 25 年商业经验和 41 年编程经验的 Jacob 仍专注于推动企业级 C#、Java 和 Python PDF 技术的创新，同时指导下一代技术领导者。

相关文章

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