ReSharper
 
Get ReSharper
Get your hands on the new features ahead of the release by joining the Early Access Program for ReSharper 2025.1! Learn more

Report and update deprecated APIs

Last modified: 08 April 2024

When evolving an API, you have to introduce breaking changes sooner or later. The traditional way of dealing with that is to mark the deprecated types and members with the [Obsolete] attribute and explain how to migrate to the new API using the attribute's message.

ReSharper provides a more elegant solution that allows API users to find and automatically convert the old API to a new one. As the API author, you need to mark the obsolete type or member with the [CodeTemplate] attribute from JetBrains.Annotations where you can specify a search pattern to match the old API and a replacement pattern for it. The attribute will work similarly to Structural Search and Replace patterns and act as a custom code inspection with the corresponding quick-fix and fixes in scope.

[CodeTemplateAttribute] is recognized by all other JetBrains products that analyze C# code, for example, JetBrains Rider JetBrains Fleet and InspectCode Command-Line Tool.

Let's see how it works using an example:

Let's annotate the deprecated IsTrue() method with the [CodeTemplate] attribute:

Now ReSharper will report all usages of MyAssert.IsTrue() and suggest a migration fix:

ReSharper: Using [CodeTemplate] attribute to suggest migration fixes for deprecated APIs