Release Notes: July 6, 2023

Hello, v2 2.5.0!

Today, we're shipping three new releases:

It's been 11 months since the release of 2.4.2 RTM.

Aside from normal quality of life improvements, the primary feature of this release is a heavily updated assertion library, which includes several new assertions, several new overloads for existing assertions, and a pass to ensure that the messages from the assertions are now more concise and consistent. We wrote up an overview of the updates in the 2.5.0 assertion library messages. For the most part, developers should not notice much compile-time differences (aside from perhaps the occasional type ambiguity that may come from new overloads); there are also some breaking binary changes, most prominently with the gutting and reworking of the exception classes that are thrown by the individual assertions. Because of some of these breaking changes, we felt it was warranted to bump the version up to 2.5.0.

This release removes all support for UWP from the core framework and VSTest adapter, based on Microsoft's deprecation of UWP in favor of WinUI 3 (and now MAUI). Users who need to continue to work with UWP will need to stay with the v2 2.4.2 core framework and 2.4.5 Visual Studio runner.

As always, we'd like to thank all the users who contributed to the success of through usage, feedback, and code contributions. 🎉

Note that we have moved away from Twitter for our occasional updates, and now make those available on our Mastodon account: You may follow along by creating a Mastodon account and following our account, or via a news reader using the RSS feed.

Release Notes

These release notes are a comprehensive list of changes from 2.4.2 to 2.5.0.

Core framework

Assertion library

New assertions

New overloads




Copyright © .NET Foundation. Contributions welcomed at