Quando alguma classe que criamos internamente mantém uma coleção, é comum termos um método público que permite a inclusão de novos itens na mesma. Geralmente se faz isso ao invés de expor diretamente a coleção, já que através deste método podemos interceptar cada item que está sendo adicionado, validar e também tomar decisões e fazer totalizações sobre cada um deles antes de efetivamente incluir na coleção.
Para exemplificar o que estou falando, considere o exemplo abaixo. Note que a cada inserção de um novo item através do método Adicionar, ele armazena na propriedade Total da classe Pedido o valor unitário do produto multiplicado pela quantidade de itens comprados.
public class Pedido { private readonly IList<Item> itens = new List<Item>(); public void Adicionar(Item item) { this.itens.Add(item); this.Total += item.Quantidade * item.Valor; } public IEnumerable<Item> Itens { get { return this.itens; } } public decimal Total { get; set; } }
Além dos benefícios que disse acima, este código, teoricamente, não permite o acesso direto à coleção interna, e sendo assim, qualquer adição tem que passar pelo método Adicionar. Só que isso não procede. Note que temos uma propriedade chamada Itens que retorna os itens através do tipo IEnumerable. Isso é possível porquê a coleção implementa esta interface. Porém, se o consumidor que estiver acessando esta propriedade fizer a conversão para IList, então o resultado não será o que desejamos:
var pedido = new Pedido(); pedido.Adicionar(new Item() { Quantidade = 2, Valor = 23 }); var lista = pedido.Itens as IList<Item>; lista.Add(new Item()); Console.WriteLine(pedido.Itens.Count()); //Retornará 2 itens
Para evitar que isso ocorra, basta no interior da propriedade Itens chamar o método de extensão ToList, ou instanciar a classe ReadOnlyCollection (System.Collections.ObjectModel), conforme os exemplos abaixo, evitando assim, que o consumidor modifique a coleção, conforme ocorreu no exemplo anterior.
//Exemplo 1 public IEnumerable<Item> Itens => itens.ToList(); //Exemplo 2 public IEnumerable<Item> Itens => new ReadOnlyCollection<Item>(itens);