List<T>.AsReadOnly Methode

Definition

Namespace:

System.Collections.Generic

Assembly:

System.Collections.dll

Quelle:

List.cs

Gibt einen schreibgeschützten ReadOnlyCollection<T>-Wrapper für die aktuelle Auflistung zurück.

C#

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

Gibt zurück

ReadOnlyCollection<T>

Ein Objekt, das als schreibgeschützter Wrapper des aktuellen List<T>-Objekts fungiert.

Beispiele

Das folgende Beispiel veranschaulicht die AsReadOnly Methode. Eine List<T> von Zeichenfolgen mit einer Kapazität von 4 wird erstellt, da die endgültige Größe der Liste bekanntlich genau 4 ist. Die Liste wird mit vier Zeichenfolgen aufgefüllt, und die AsReadOnly -Methode wird verwendet, um eine schreibgeschützte IList<T> generische Schnittstellenimplementierung abzurufen, die die ursprüngliche Liste umschließt.

Ein Element der ursprünglichen Liste wird mithilfe der Item[] -Eigenschaft (der Indexer in C#) auf "Coelophysis" festgelegt, und der Inhalt der schreibgeschützten Liste wird erneut angezeigt, um zu zeigen, dass es sich nur um einen Wrapper für die ursprüngliche Liste handelt.

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

Hinweise

Um Änderungen am List<T> Objekt zu verhindern, machen Sie es nur über diesen Wrapper verfügbar. Ein ReadOnlyCollection<T> -Objekt macht keine Methoden verfügbar, die die Auflistung ändern. Wenn jedoch Änderungen am zugrunde liegenden List<T> Objekt vorgenommen werden, spiegelt die schreibgeschützte Auflistung diese Änderungen wider.

Bei dieser Methode handelt es sich um einen O(1)-Vorgang.

Gilt für: