Classe ReadOnlyCollection<T>

Uma instância de ReadOnlyCollection<T> classe genérica é sempre somente leitura. Uma coleção que é somente leitura é simplesmente uma coleção com um invólucro que impede a modificação da coleção; Portanto, se forem feitas alterações à coleção subjacente, a coleção somente leitura reflete essas alterações. Consulte Collection<T> para obter uma versão modificada desta classe.

Essa classe base é fornecida para facilitar implementadores criar uma coleção de personalizado genérica somente leitura. Implementadores são incentivados a estender essa classe base em vez de criar seus próprios.

O exemplo de código a seguir demonstra vários membros na ReadOnlyCollection<T> classe. O exemplo de código cria uma List<T> de strings e adiciona quatro nomes dinosaur a ela. O exemplo de código, em seguida, empacota a lista em um ReadOnlyCollection<T>.

Depois de demonstrar a Count, Contains, Item, e IList.IndexOf membros, o exemplo de código mostra que o ReadOnlyCollection<T> é apenas um invólucro para o original List<T> , adicionando um novo item para o List<T> e exibir o conteúdo da ReadOnlyCollection<T>.

Finalmente, o exemplo de código cria uma matriz maior do que a coleção e usa o CopyTo método para inserir os elementos da coleção no meio da matriz.

using System;
using System.Collections.Generic;
using System.Collections.ObjectModel;

public class Example
{
    public static void Main()
    {
        List<string> dinosaurs = new List<string>();

        dinosaurs.Add("Tyrannosaurus");
        dinosaurs.Add("Amargasaurus");
        dinosaurs.Add("Deinonychus");
        dinosaurs.Add("Compsognathus");

        ReadOnlyCollection<string> readOnlyDinosaurs = 
            new ReadOnlyCollection<string>(dinosaurs);

        Console.WriteLine();
        foreach( string dinosaur in readOnlyDinosaurs )
        {
            Console.WriteLine(dinosaur);
        }

        Console.WriteLine("\nCount: {0}", readOnlyDinosaurs.Count);

        Console.WriteLine("\nContains(\"Deinonychus\"): {0}", 
            readOnlyDinosaurs.Contains("Deinonychus"));

        Console.WriteLine("\nreadOnlyDinosaurs[3]: {0}", 
            readOnlyDinosaurs[3]);

        Console.WriteLine("\nIndexOf(\"Compsognathus\"): {0}", 
            readOnlyDinosaurs.IndexOf("Compsognathus"));

        Console.WriteLine("\nInsert into the wrapped List:");
        Console.WriteLine("Insert(2, \"Oviraptor\")");
        dinosaurs.Insert(2, "Oviraptor");

        Console.WriteLine();
        foreach( string dinosaur in readOnlyDinosaurs )
        {
            Console.WriteLine(dinosaur);
        }

        string[] dinoArray = new string[readOnlyDinosaurs.Count + 2];
        readOnlyDinosaurs.CopyTo(dinoArray, 1);

        Console.WriteLine("\nCopied array has {0} elements:", 
            dinoArray.Length);
        foreach( string dinosaur in dinoArray )
        {
            Console.WriteLine("\"{0}\"", dinosaur);
        }
    }
}

/* This code example produces the following output:

Tyrannosaurus
Amargasaurus
Deinonychus
Compsognathus

Count: 4

Contains("Deinonychus"): True

readOnlyDinosaurs[3]: Compsognathus

IndexOf("Compsognathus"): 3

Insert into the wrapped List:
Insert(2, "Oviraptor")

Tyrannosaurus
Amargasaurus
Oviraptor
Deinonychus
Compsognathus

Copied array has 7 elements:
""
"Tyrannosaurus"
"Amargasaurus"
"Oviraptor"
"Deinonychus"
"Compsognathus"
""
 */

.NET Framework

.NET Framework Client Profile

Biblioteca de Classes Portátil

.NET para aplicativos da Windows Store

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

Membro público estático (Shared em Visual Basic) membros desse tipo são thread-safe. Os membros da instâncianão estãogarantias de serem thread safe.

A ReadOnlyCollection<T> pode suportar vários leitores simultaneamente, desde que a coleção não é modificada. Mesmo assim, enumerando através de uma coleção intrinsecamente não é um procedimento de thread-safe. Para garantir segurança de segmentos durante enumeração, você pode bloquear a coleção durante toda a enumeração. Para permitir que a coleção seja acessada por vários segmentos de leitura e gravação, você deve implementar sua sincronização.

Referência