{"id":1431,"date":"2025-03-11T22:00:00","date_gmt":"2025-03-11T21:00:00","guid":{"rendered":"https:\/\/demo.sidekick.be\/itenium\/testing-frameworks\/"},"modified":"2025-11-28T13:31:42","modified_gmt":"2025-11-28T12:31:42","slug":"testing-frameworks","status":"publish","type":"post","link":"https:\/\/demo.sidekick.be\/itenium\/blog\/dotnet\/testing-frameworks\/","title":{"rendered":".NET Testing Frameworks"},"content":{"rendered":"

Target audience: A developer switching frameworks \ud83d\ude42<\/p>\n

Test Suites<\/h1>\n

Typically test classes and\/or methods are decorated with Attributes.<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
<\/th>\nNUnit<\/th>\nxUnit<\/th>\nMSTest<\/th>\nTUnit<\/th>\n<\/tr>\n<\/thead>\n
Namespace<\/td>\nNUnit.Framework<\/td>\nXunit<\/td>\nMicrosoft.VisualStudio
.TestTools.UnitTesting<\/td>\n		TUnit<\/td>\n<\/tr>\n
Class Attribute<\/td>\nTestFixture<\/a> (optional)<\/td>\n<\/td>\nTestClass<\/td>\n<\/td>\n<\/tr>\n
Method Attribute<\/td>\nTest<\/a><\/td>\nFact<\/td>\nTestMethod<\/td>\nTest<\/td>\n<\/tr>\n
Ignoring<\/td>\nIgnore<\/a><\/td>\nFact(Skip=\u201d\u201d)<\/td>\nIgnore<\/td>\nSkip<\/td>\n<\/tr>\n
Setup & Teardown<\/strong><\/td>\n<\/td>\n<\/td>\n<\/td>\n<\/td>\n<\/tr>\n
Before all tests<\/td>\nOneTimeSetUp<\/a><\/td>\nIClassFixture<T><\/td>\nClassInitialize<\/td>\nBefore(Class)<\/td>\n<\/tr>\n
Before each test<\/td>\nSetUp<\/a><\/td>\nConstructor<\/td>\nTestInitialize<\/td>\nBefore(Test)<\/td>\n<\/tr>\n
After each test<\/td>\nTearDown<\/a><\/td>\nIDisposable.Dispose<\/td>\nTestCleanup<\/td>\nAfter(Test)<\/td>\n<\/tr>\n
After all tests<\/td>\nOneTimeTearDown<\/a><\/td>\nIClassFixture<T><\/td>\nClassCleanup<\/td>\nAfter(Class)<\/td>\n<\/tr>\n
Meta data<\/strong><\/td>\n<\/td>\n<\/td>\n<\/td>\n<\/td>\n<\/tr>\n
Description<\/td>\nDescription<\/a><\/td>\n<\/td>\nDescription<\/td>\n<\/td>\n<\/tr>\n
Categories<\/td>\nCategory<\/a><\/td>\nTrait(\u201cCategory\u201d, \u201c\u201d)<\/td>\nTestCategory<\/td>\nCategory<\/td>\n<\/tr>\n
Custom properties<\/td>\nProperty<\/a><\/td>\nTrait<\/td>\nTestProperty<\/td>\nProperty<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

xUnit IClassFixture<\/h4>\n

Setup in xUnit doesn\u2019t work with Attributes!
xUnit injects the same XUnitTestsFixture<\/code> to the constructor before running each [Fact]<\/code>.<\/p>\n

It\u2019s also possible to do setup\/teardown for all tests within classes decorated with a CollectionAttribute<\/code> with ICollectionFixture<T><\/code>, see shared-context<\/a> for more info.<\/p>\n

public class XUnitTestsFixture : IDisposable\n{\n    public XUnitTestsFixture() { \/* BeforeAllTests *\/ }\n    public void Dispose() { \/* AfterAllTests *\/ }\n}\n\npublic class XUnitTestsWithSetUp : IClassFixture<XUnitTestsFixture>\n{\n    private readonly XUnitTestsFixture _fixture;\n\n    public XUnitTestsWithSetUp(XUnitTestsFixture fixture)\n    {\n        _fixture = fixture;\n    }\n\n    [Fact]\n    public void Test1() { }\n}\n<\/code><\/pre>\n
Assembly setup<\/h2>\n
xUnit<\/h3>\n
As per the IClassFixture<T><\/code> example above, the XUnitTestsFixture<\/code> will be injected in all test classes in the assembly.<\/p>\n
[assembly: AssemblyFixture(typeof(XUnitTestsFixture))]\n<\/code><\/pre>\n
NUnit<\/h3>\n
[SetUpFixture]\npublic class Config\n{\n    [OneTimeSetUp]\n    public void SetUp() { }\n\n    [OneTimeTearDown]\n    public void TearDown() { }\n}\n<\/code><\/pre>\n
MSTest<\/h3>\n
[TestClass]\npublic class MyTestClass\n{\n    [AssemblyInitialize]\n    public static void AssemblyInitialize(TestContext testContext)\n    {\n        \/\/ Or return Task!\n    }\n\n    [AssemblyCleanup]\n    public static void AssemblyCleanup()\n    {\n        \/\/ Or return Task!\n    }\n}\n<\/code><\/pre>\n
TUnit<\/h3>\n
public class TUnitSetup\n{\n  [Before(Assembly)]\n  public static async Task AssemblySetup() { }\n\n  [After(Assembly)]\n  public static async Task AssemblyTeardown()\n  {\n    \/\/ Runs after the last test in GetType().Assembly\n  }\n\n  [AfterEvery(Assembly)]\n  public static async Task AllAssembliesTeardown(AssemblyHookContext context)\n  {\n    \/\/ Runs after the last test in all assemblies\n    \/\/ For all Before\/After there exists a Before\/AfterEvery\n    \/\/ Aside from Test\/Class\/Assembly there also is TestSession\/TestDiscovery\n  }\n}\n<\/code><\/pre>\n
Assertions<\/h1>\n
bool? actual = true;\n\n\/\/ NUnit\nAssert.That(actual, Is.EqualTo(true));\n\n\/\/ xUnit\nAssert.Equal(true, actual);\n\n\/\/ MSTest\nAssert.AreEqual(true, actual);\n\n\/\/ TUnit\nawait Assert.That(actual).IsEqualTo(true);\n<\/code><\/pre>\n
Basic<\/h2>\n\n\n\n\n\n\n\n\n\n
NUnit<\/th>\nxUnit<\/th>\nMSTest<\/th>\nTUnit<\/th>\nNotes<\/th>\n<\/tr>\n<\/thead>\n
Is.EqualTo<\/td>\nEqual<\/td>\nAreEqual<\/td>\nIsEqualTo<\/td>\nUsing IEquatable<\/T><\/td>\n<\/tr>\n
Is.Not.EqualTo<\/td>\nNotEqual<\/td>\nAreNotEqual<\/td>\nIsNotEqualTo<\/td>\n<\/td>\n<\/tr>\n
Is.Null<\/td>\nNull<\/td>\nIsNull<\/td>\nIsNull<\/td>\n<\/td>\n<\/tr>\n
Is.True<\/td>\nTrue<\/td>\nIsTrue<\/td>\nIsTrue<\/td>\n<\/td>\n<\/tr>\n
Is.SameAs<\/td>\nSame<\/td>\nAreSame<\/td>\nIsSameReferenceAs<\/td>\nSame referenced object<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
Strings<\/h2>\n
All but NUnit use an overload to ignore case for Start\/End with.<\/p>\n\n\n\n\n\n\n\n\n\n\n
NUnit<\/th>\nxUnit<\/th>\nMSTest<\/th>\nTUnit<\/th>\n<\/tr>\n<\/thead>\n
Is.Empty<\/td>\nEmpty<\/td>\n<\/td>\nIsEmpty<\/td>\n<\/tr>\n
Does.Contain<\/td>\nContains<\/td>\nStringAssert.Contains<\/td>\nContains<\/td>\n<\/tr>\n
Does.Not.Contain<\/td>\nDoesNotContain<\/td>\nStringAssert.DoesNotMatch<\/td>\nDoesNotContain<\/td>\n<\/tr>\n
Does.StartWith<\/td>\nStartsWith<\/td>\nStringAssert.StartsWith<\/td>\nStartsWith<\/td>\n<\/tr>\n
Does.EndWith().IgnoreCase<\/td>\nEndsWith<\/td>\nStringAssert.EndsWith<\/td>\nEndsWith<\/td>\n<\/tr>\n
Does.Match<\/td>\nMatches<\/td>\nStringAssert.Matches<\/td>\nMatches<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
Exceptions<\/h2>\n
Action sut = () => throw new Exception(\"cause\");\nFunc<Task> asyncSut = () => throw new Exception(\"cause\");\n\n\/\/ NUnit\nvar ex = Assert.Throws<Exception>(() => sut(), \"failure message\");\nAssert.That(ex.Message, Is.EqualTo(\"cause\"));\n\nvar ex2 = Assert.ThrowsAsync<Exception>(() => asyncSut());\nAssert.That(ex2.Message, Is.EqualTo(\"cause\"));\n\n\n\/\/ xUnit\nvar ex = Assert.Throws<Exception>(sut);\nAssert.Equal(\"cause\", ex.Message);\n\nvar ex2 = await Assert.ThrowsAsync<Exception>(() => asyncSut());\nAssert.Equal(\"cause\", ex2.Message);\n\n\n\/\/ MSTest\n\/\/ DEPRECATED: ExpectedExceptionAttribute(typeof(Exception))\n\/\/ DEPRECATED: ThrowsException<T>()\nvar ex = Assert.ThrowsExactly<Exception>(sut);\nAssert.AreEqual(\"cause\", ex.Message);\n\nvar ex2 = await Assert.ThrowsExactlyAsync<Exception>(asyncSut);\nAssert.AreEqual(\"cause\", ex2.Message);\n\n\n\/\/ TUnit\n\/\/ Also: .WithMessageMatching and .WithInnerException\nawait Assert.That(sut).ThrowsExactly<Exception>().WithMessage(\"cause\");\n\nawait Assert.That(asyncSut)\n  .ThrowsExactly<ArgumentException>()\n  .WithMessageMatching(StringMatcher.AsRegex(\"^cause$\"));\n<\/code><\/pre>\n
Exact vs Derived<\/h3>\n
The above assertions expect the exceptions to be of exactly the type provided. If you do not want a failure when the actual type is a derived type:<\/p>\n