JetBrains Rider 2024.3 Help

Collection access analysis

Besides analyzing values of collection items, JetBrains Rider also analyzes each collection you use as a whole — it warns you when a collection is never filled or modified even if there is a read access to this collection:

JetBrains Rider warns you that a collection is read before ever being filled or modified.

or instead, if a collection is never read:

JetBrains Rider warns you that a collection is never read.

All standard collection types are analyzed this way by default. If necessary, you can also apply this analysis to your custom collections that derive from IEnumerable. In this case, you need to tell JetBrains Rider how invocations of collection’s public methods will affect the contents of the collection. To do so, mark the methods of your collection class with the [CollectionAccessAttribute], which should have one of four flags: None, Read, ModifyExisitingContent, UpdatedContent (the difference between the last two flags is that UpdatedContent means that the marked function can also add new elements to the collection). Here is a simple example to illustrate this:

Using JetBrains.Annotations to improve code analysis of collection access
Last modified: 11 February 2024