.NET 4.5 Read-Only Interfaces

Article
1/17/2024

Introduction

Read-only interfaces were introduced only recently with .NET 4.5. They essentially have all the functionality for modifying collections from generic interfaces removed, letting you expose interfaces to other code without any risk of that code being able to use those interfaces to modify collections.

Hierarchical Diagram

http://www.c-sharpcorner.com/UploadFile/91c28d/net-4-5-read-only-interfaces/Images/Capture.PNG

In the preceding hierarchical diagram you can see core generic interfaces and read-only interface.

Look at the read-only part of the hierarchy. The read-only interfaces start with an interface called IReadOnlyCollection that mirrors ICollection. We saw that the main branch splits into three at this point. The read-only interfaces do the same thing except that there's no read-only equivalent of ISet. The only read-only interfaces are IReadOnlyList and IReadOnlyDictionary. As we mentioned earlier, read-only interfaces do not expose anything to modify the collection.

IReadOnlyCollection<T>

This is a very simple interface. We can start from ICollection. You can see the ICollection interface in the following sample.

http://www.c-sharpcorner.com/UploadFile/91c28d/net-4-5-read-only-interfaces/Images/image1.png

Remove all the stuff to do the modification of the collection and we also remove the Contains() and CopyTo() methods.

http://www.c-sharpcorner.com/UploadFile/91c28d/net-4-5-read-only-interfaces/Images/image2.png

So what are we left with? Yes, the Count property. IReadOnlyCollection is an enumerable that also knows how many elements it has and I think that's potentially rather a nice interface to have available.

http://www.c-sharpcorner.com/UploadFile/91c28d/net-4-5-read-only-interfaces/Images/image3.png

IReadOnlyList<T>

IReadOnlyList follows the spirit of IReadOnlyCollection. It adds those IList methods that are read-only and unambiguously useful and this is the result. You get IReadOnlyCollection plus the indexer, but only read-only access and that's it. In the following picture you can see the IReadOnlyList<T> interface.

http://www.c-sharpcorner.com/UploadFile/91c28d/net-4-5-read-only-interfaces/Images/image4.png

Example

http://www.c-sharpcorner.com/UploadFile/91c28d/net-4-5-read-only-interfaces/Images/image5.png

IReadOnlyDictionary<TKey, TValue>

IReadOnlyDictionary is unusually for the read-only interfaces and is quite powerful. It contains all the added functionality of IDictionary except obviously for the ability to add or remove items. In the following sample you can see the IDictionary interface.

http://www.c-sharpcorner.com/UploadFile/91c28d/net-4-5-read-only-interfaces/Images/image6.png

You can see the IReadOnlyDictionary<Tkey,TValue> interface below.

public interface  IReadOnlyDictionary < TKey, TValue > : IReadOnlyCollection < KeyValuePair < TKey,  
TValue >> ,  
IEnumerable < KeyValuePair < TKey,  
TValue >> ,  
IEnumerable  
  {  
    IEnumerable < TKey > Keys  
    {  
        get;  
    }  
    IEnumerable < TValue > Values  
    {  
        get;  
    }  
    TValue this[TKey key]  
    {  
        get;  
    }  
    bool ContainsKey(TKey key);  
    bool TryGetValue(TKey key, out TValue value);  
}

The IReadOnlyDictionary<Tkey,TValue> interface looks quite nice and useful if you want to expose read-only functionality on a Dictionary.

Summary

Read-only interfaces look quite nice and useful if you want to expose read-only functionality on core generic type interfaces like ICollection<T>, IList<T> and IDictionary<Tkey,Tvalue>.
**
**

Share via