IEnumerable vs IReadonlyCollection vs ReadonlyCollection for exposing a list member

by

One important aspect seems to be missing from the answers so far:

When an IEnumerable<T> is returned to the caller, they must consider the possibility that the returned object is a “lazy stream”, e.g. a collection built with “yield return”. That is, the performance penalty for producing the elements of the IEnumerable<T> may have to be paid by the caller, for each use of the IEnumerable. (The productivity tool “Resharper” actually points this out as a code smell.)

By contrast, an IReadOnlyCollection<T> signals to the caller that there will be no lazy evaluation. (The Count property, as opposed to the Count extension method of IEnumerable<T> (which is inherited by IReadOnlyCollection<T> so it has the method as well), signals non-lazyness. And so does the fact that there seem to be no lazy implementations of IReadOnlyCollection.)

This is also valid for input parameters, as requesting an IReadOnlyCollection<T> instead of IEnumerable<T> signals that the method needs to iterate several times over the collection. Sure the method could create its own list from the IEnumerable<T> and iterate over that, but as the caller may already have a loaded collection at hand it would make sense to take advantage of it whenever possible. If the caller only has an IEnumerable<T> at hand, he only needs to add .ToArray() or .ToList() to the parameter.

What IReadOnlyCollection does not do is prevent the caller to cast to some other collection type. For such protection, one would have to use the class ReadOnlyCollection<T>.

In summary, the only thing IReadOnlyCollection<T> does relative to IEnumerable<T> is add a Count property and thus signal that no lazyness is involved.

More Related Contents:

  1. When a class is inherited from List, XmlSerializer doesn’t serialize other attributes
  2. IEnumerable vs List – What to Use? How do they work?
  3. ArrayList vs List in C#
  4. What is the best way to modify a list in a ‘foreach’ loop?
  5. How do arrays in C# partially implement IList?
  6. How can I add an item to a IEnumerable collection?
  7. Remove items from one list in another
  8. Does .NET have a way to check if List a contains all items in List b?
  9. How to get the index of an element in an IEnumerable?
  10. Pair-wise iteration in C# or sliding window enumerator
  11. Passing a single item as IEnumerable
  12. ICollection Vs List in Entity Framework
  13. How to check if IEnumerable is null or empty?
  14. Differences between IQueryable, List, IEnumerator?
  15. Converting from IEnumerable to List [duplicate]
  16. IEnumerable to string [duplicate]
  17. What is the difference between IEnumerator and IEnumerable? [duplicate]
  18. Generic List – moving an item within the list
  19. How to concatenate two IEnumerable into a new IEnumerable?
  20. How do I get a list of installed updates and hotfixes?
  21. C#: How to add subitems in ListView
  22. Collection was modified; enumeration may not execute error when removing a ListItem from a LIstBox
  23. Is there an IEnumerable implementation that only iterates over it’s source (e.g. LINQ) once?
  24. Using Linq Except not Working as I Thought
  25. Pair-wise iteration in C#, or sliding window enumerator
  26. What is the purpose of AsQueryable()?
  27. Casting IEnumerable to List
  28. IEnumerable and order
  29. method without access modifier
  30. generic NOT constraint where T : !IEnumerable

Leave a Comment