如何在C# .NET WinForms中Mock MessageBox并执行断言测试

核心思路是将MessageBox的交互逻辑抽象为接口，让业务类依赖接口而非具体的WinForms MessageBox实现，这样测试时可以用Mock对象替代真实的MessageBox，无需在测试项目中引用Windows Forms。

步骤1：定义MessageBox服务接口 #

创建一个包含MessageBox关键方法的接口，覆盖你业务中用到的Show重载：

public interface IMessageBoxService
{
    // 根据实际需求重载Show方法
    DialogResult Show(string text);
    DialogResult Show(string text, string caption);
    DialogResult Show(string text, string caption, MessageBoxButtons buttons);
    DialogResult Show(string text, string caption, MessageBoxButtons buttons, MessageBoxIcon icon);
}

步骤2：实现WinForms版的MessageBox服务 #

在你的WinForms项目中，实现上述接口，内部调用真实的WinForms MessageBox：

public class WinFormsMessageBoxService : IMessageBoxService
{
    public DialogResult Show(string text) => MessageBox.Show(text);
    public DialogResult Show(string text, string caption) => MessageBox.Show(text, caption);
    public DialogResult Show(string text, string caption, MessageBoxButtons buttons) => MessageBox.Show(text, caption, buttons);
    public DialogResult Show(string text, string caption, MessageBoxButtons buttons, MessageBoxIcon icon) => MessageBox.Show(text, caption, buttons, icon);
}

步骤3：在业务类中注入接口 #

修改你的业务类，通过构造函数注入IMessageBoxService，替换直接调用MessageBox.Show的代码：

public class OrderProcessor
{
    private readonly IMessageBoxService _messageBoxService;

    // 构造注入，让业务类依赖抽象而非具体实现
    public OrderProcessor(IMessageBoxService messageBoxService)
    {
        _messageBoxService = messageBoxService ?? throw new ArgumentNullException(nameof(messageBoxService));
    }

    public void ProcessOrder(Order order)
    {
        // 业务逻辑...
        if (order.TotalAmount < 0)
        {
            _messageBoxService.Show("订单金额无效", "错误提示", MessageBoxButtons.OK, MessageBoxIcon.Error);
            return;
        }

        // 其他逻辑...
        _messageBoxService.Show("订单处理完成", "成功", MessageBoxButtons.OK, MessageBoxIcon.Information);
    }
}

步骤4：编写单元测试（无需引用WinForms） #

在测试项目中，使用Mock框架（如Moq）创建IMessageBoxService的Mock实例，注入到业务类后验证调用情况：

using Moq;
using Microsoft.VisualStudio.TestTools.UnitTesting;

[TestClass]
public class OrderProcessorTests
{
    [TestMethod]
    public void ProcessOrder_InvalidAmount_ShowsErrorMessageBox()
    {
        // Arrange
        var mockMessageBox = new Mock<IMessageBoxService>();
        var invalidOrder = new Order { TotalAmount = -100 };
        var processor = new OrderProcessor(mockMessageBox.Object);

        // Act
        processor.ProcessOrder(invalidOrder);

        // Assert：验证MessageBox是否以预期参数被调用一次
        mockMessageBox.Verify(m => m.Show(
            "订单金额无效", 
            "错误提示", 
            MessageBoxButtons.OK, 
            MessageBoxIcon.Error), 
            Times.Once);
    }

    [TestMethod]
    public void ProcessOrder_ValidAmount_ShowsSuccessMessageBox()
    {
        // Arrange
        var mockMessageBox = new Mock<IMessageBoxService>();
        var validOrder = new Order { TotalAmount = 500 };
        var processor = new OrderProcessor(mockMessageBox.Object);

        // Act
        processor.ProcessOrder(validOrder);

        // Assert
        mockMessageBox.Verify(m => m.Show(
            "订单处理完成", 
            "成功", 
            MessageBoxButtons.OK, 
            MessageBoxIcon.Information), 
            Times.Once);
    }
}

如果需要模拟用户点击不同按钮的场景，还可以设置Mock的返回值：

// 模拟用户点击"Yes"按钮
mockMessageBox.Setup(m => m.Show(It.IsAny<string>(), It.IsAny<string>(), MessageBoxButtons.YesNo, It.IsAny<MessageBoxIcon>()))
              .Returns(DialogResult.Yes);

这种方式完全解耦了业务逻辑与WinForms的UI依赖，测试项目只需引用包含IMessageBoxService的类库（无需引用Windows Forms），即可完成对MessageBox调用行为的验证。

内容的提问来源于stack exchange，提问作者williamqmoura