Testing an ASP.NET Core web app with Testcontainers

In this guide, you'll learn how to:

• Use Testcontainers for .NET to spin up a Microsoft SQL Server container for integration tests
• Replace SQLite with a production-like database provider in ASP.NET Core tests
• Customize WebApplicationFactory to configure test dependencies with Testcontainers
• Manage container lifecycle with xUnit's IAsyncLifetime

Prerequisites

• .NET 8.0+ SDK
• A code editor or IDE (Visual Studio, VS Code, Rider)
• A Docker environment supported by Testcontainers. For details, see the Testcontainers .NET system requirements.

Note

If you're new to Testcontainers, visit the Testcontainers overview to learn more about Testcontainers and the benefits of using it.

Modules

1. Create the project

   Set up an ASP.NET Core Razor Pages project with integration test dependencies.

2. Write tests

   Replace SQLite with a real Microsoft SQL Server using Testcontainers for .NET.

3. Run tests

   Run the Testcontainers-based integration tests and explore next steps.