List<T>.AsReadOnly Метод

Определение

Пространство имен:

System.Collections.Generic

Сборка:

System.Collections.dll

Исходный код:

List.cs

Возвращает для текущей коллекции оболочку ReadOnlyCollection<T>, доступную только для чтения.

C#

public System.Collections.ObjectModel.ReadOnlyCollection<T> AsReadOnly ();

Возвращаемое значение

ReadOnlyCollection<T>

Объект, который служит оболочкой, обеспечивающей доступность текущего списка List<T> только для чтения.

Примеры

В следующем примере демонстрируется AsReadOnly метод. Создается List<T> строка с емкостью 4, так как конечный размер списка, как известно, ровно 4. Список заполняется четырьмя строками, а AsReadOnly метод используется для получения реализации универсального интерфейса только IList<T> для чтения, который упаковывает исходный список.

Элемент исходного списка имеет значение "Coelophysis" с помощью Item[] свойства (индексатор в C#), а содержимое списка, доступного только для чтения, снова отображается, чтобы продемонстрировать, что это всего лишь оболочка для исходного списка.

C#

using System;
using System.Collections.Generic;

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

        Console.WriteLine("\nCapacity: {0}", dinosaurs.Capacity);

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

        Console.WriteLine();
        foreach(string s in dinosaurs)
        {
            Console.WriteLine(s);
        }

        Console.WriteLine("\nIList<string> roDinosaurs = dinosaurs.AsReadOnly()");
        IList<string> roDinosaurs = dinosaurs.AsReadOnly();

        Console.WriteLine("\nElements in the read-only IList:");
        foreach(string dinosaur in roDinosaurs)
        {
            Console.WriteLine(dinosaur);
        }

        Console.WriteLine("\ndinosaurs[2] = \"Coelophysis\"");
        dinosaurs[2] = "Coelophysis";

        Console.WriteLine("\nElements in the read-only IList:");
        foreach(string dinosaur in roDinosaurs)
        {
            Console.WriteLine(dinosaur);
        }
    }
}

/* This code example produces the following output:

Capacity: 4

Tyrannosaurus
Amargasaurus
Mamenchisaurus
Deinonychus

IList<string> roDinosaurs = dinosaurs.AsReadOnly()

Elements in the read-only IList:
Tyrannosaurus
Amargasaurus
Mamenchisaurus
Deinonychus

dinosaurs[2] = "Coelophysis"

Elements in the read-only IList:
Tyrannosaurus
Amargasaurus
Coelophysis
Deinonychus
 */

Комментарии

Чтобы предотвратить любые изменения List<T> объекта, предоставляйте его только через эту оболочку. Объект ReadOnlyCollection<T> не предоставляет методы, которые изменяют коллекцию. Однако при внесении изменений в базовый List<T> объект коллекция только для чтения отражает эти изменения.

Этот метод является операцией O(1).

Применяется к