ReadOnlyCollection<T>(IList<T>) Constructor

Definición

Espacio de nombres:

System.Collections.ObjectModel

Ensamblado:

System.Runtime.dll

Source:

ReadOnlyCollection.cs

Inicializa una nueva instancia de la clase ReadOnlyCollection<T> que es un contenedor de solo lectura para la lista especificada.

C#

public ReadOnlyCollection (System.Collections.Generic.IList<T> list);

Parámetros

list

IList<T>

Lista que se va a incluir.

Excepciones

ArgumentNullException

list es null.

Ejemplos

En el ejemplo de código siguiente se muestra este constructor y varios miembros de la ReadOnlyCollection<T> clase .

El ejemplo de código crea una List<T> de cadenas y le agrega cuatro nombres de dinosaurio. A continuación, el ejemplo de código encapsula la lista en un ReadOnlyCollection<T> elemento pasandola al constructor .

Después de mostrar los Countmiembros , Contains, Item[]y IList.IndexOf , el ejemplo de código muestra que ReadOnlyCollection<T> es solo un contenedor para el original List<T> agregando un nuevo elemento a List<T> y mostrando el contenido de ReadOnlyCollection<T>.

Por último, el ejemplo de código crea una matriz mayor que la colección y usa el CopyTo método para insertar los elementos de la colección en el centro de la matriz.

C#

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"
""
 */

Comentarios

Para evitar modificaciones en list, exponga list solo a través de este contenedor.

Una colección que es de solo lectura es simplemente una colección con un contenedor que impide modificar la colección; por lo tanto, si se realizan cambios en la colección subyacente, la colección de solo lectura refleja esos cambios.

Este constructor es una operación O(1).

Se aplica a

Consulte también

• IList<T>