List<T>.AsReadOnly Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Zwraca otokę tylko ReadOnlyCollection<T> do odczytu dla bieżącej kolekcji.
public:
System::Collections::ObjectModel::ReadOnlyCollection<T> ^ AsReadOnly();public System.Collections.ObjectModel.ReadOnlyCollection<T> AsReadOnly();member this.AsReadOnly : unit -> System.Collections.ObjectModel.ReadOnlyCollection<'T>Public Function AsReadOnly () As ReadOnlyCollection(Of T)Zwraca
Obiekt, który działa jako otoka tylko do odczytu wokół bieżącego List<T>obiektu .
Przykłady
W poniższym przykładzie przedstawiono metodę AsReadOnly . Tworzona List<T> jest liczba ciągów o pojemności 4, ponieważ ostateczny rozmiar listy jest znany dokładnie 4. Lista jest wypełniana czterema ciągami, a AsReadOnly metoda służy do uzyskiwania implementacji interfejsu ogólnego tylko IList<T> do odczytu, która opakowuje oryginalną listę.
Element oryginalnej listy jest ustawiony na "Coelophysis" przy użyciu Item[] właściwości (indeksator w języku C#), a zawartość listy tylko do odczytu jest wyświetlana ponownie, aby zademonstrować, że jest to tylko otoka oryginalnej listy.
using System;
using System.Collections.Generic;
public partial class Program
{
public static void Main()
{
List<string> animals = new List<string>(4);
Console.WriteLine("\nCapacity: {0}", animals.Capacity);
animals.Add("Cat");
animals.Add("Dog");
animals.Add("Squirrel");
animals.Add("Wolf");
Console.WriteLine();
foreach (string animal in animals)
{
Console.WriteLine(animal);
}
Console.WriteLine("\nIList<string> roAnimals = animals.AsReadOnly()");
IList<string> roAnimals = animals.AsReadOnly();
Console.WriteLine("\nElements in the read-only IList:");
foreach (string animal in roAnimals)
{
Console.WriteLine(animal);
}
Console.WriteLine("\nanimals[2] = \"Lion\"");
animals[2] = "Lion";
Console.WriteLine("\nElements in the read-only IList:");
foreach (string animal in roAnimals)
{
Console.WriteLine(animal);
}
}
}
/*
This code example produces the following output:
Capacity: 4
Cat
Dog
Squirrel
Wolf
IList<string> roAnimals = animals.AsReadOnly()
Elements in the read-only IList:
Cat
Dog
Squirrel
Wolf
animals[2] = "Lion"
Elements in the read-only IList:
Cat
Dog
Lion
Wolf
*/
Imports System.Collections.Generic
Partial Public Class Program
Public Shared Sub Main()
Dim animals As New List(Of String)(4)
Console.WriteLine(vbLf & "Capacity: {0}", animals.Capacity)
animals.Add("Cat")
animals.Add("Dog")
animals.Add("Squirrel")
animals.Add("Wolf")
Console.WriteLine()
For Each animal As String In animals
Console.WriteLine(animal)
Next
Console.WriteLine(vbLf & _
"Dim roAnimals As IList(Of String) = animals.AsReadOnly")
Dim roAnimals As IList(Of String) = animals.AsReadOnly
Console.WriteLine(vbLf & "Elements in the read-only IList:")
For Each animal As String In roAnimals
Console.WriteLine(animal)
Next
Console.WriteLine(vbLf & "animals(2) = ""Lion""")
animals(2) = "Lion"
Console.WriteLine(vbLf & "Elements in the read-only IList:")
For Each animal As String In roAnimals
Console.WriteLine(animal)
Next
End Sub
End Class
' This code example produces the following output:
'
' Capacity: 4
'
' Cat
' Dog
' Squirrel
' Wolf
'
' Dim roAnimals As IList(Of String) = animals.AsReadOnly
'
' Elements in the read-only IList:
' Cat
' Dog
' Squirrel
' Wolf
'
' animals(2) = "Lion"
'
' Elements in the read-only IList:
' Cat
' Dog
' Lion
' Wolf
Uwagi
Aby zapobiec wszelkim modyfikacjom List<T> obiektu, uwidocznij go tylko za pośrednictwem tej otoki. Obiekt ReadOnlyCollection<T> nie ujawnia metod modyfikujących kolekcję. Jeśli jednak zmiany zostaną wprowadzone w obiekcie bazowym List<T> , kolekcja tylko do odczytu odzwierciedla te zmiany.
Ta metoda jest operacją O(1).
