Upgrade Driver Versions
Overview
Use the guides on this page to identify the potentially breaking changes that each version of the .NET/C# Driver introduces. This page also provides information about breaking compatibility changes between the driver and MongoDB.
A breaking change is a modification of a convention or a behavior starting in a specific version of the driver. This type of change may prevent your application from working properly if you don't address it.
Tip
Stable API
To minimize the number of changes your application might require when you upgrade driver versions in the future, consider using the Stable API.
Upgrade Guides
Server Release Compatibility Changes
A server release compatibility change is a modification to the MongoDB .NET/C# Driver that discontinues support for a set of MongoDB Server versions.
The driver discontinues support for a MongoDB Server version after it reaches end-of-life (EOL).
To learn more about the MongoDB support for EOL products, see the Legacy Support Policy.
Server Version 8.1 Support Changes
You cannot use v2.14.1 or earlier versions of the .NET/C# Driver to connect to a
deployment running MongoDB Server v8.1. Starting in MongoDB Server v8.1,
the buildinfo command requires authentication, causing an
incompatibility with these driver versions.