List<T>.AsReadOnly Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Devolve um wrapper de apenas ReadOnlyCollection<T> leitura para a coleção atual.
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)Devoluções
Um objeto que atua como um wrapper de apenas leitura em torno da corrente List<T>.
Exemplos
O exemplo seguinte demonstra o AsReadOnly método. A List<T> de cadeias com capacidade de 4 é criado, porque o tamanho final da lista é conhecido por ser exatamente 4. A lista é preenchida com quatro strings, e o AsReadOnly método é usado para obter uma implementação genérica de interface de apenas IList<T> leitura que envolve a lista original.
Um elemento da lista original é definido como "Coelophysis" usando a Item[] propriedade (o indexador em C#), e o conteúdo da lista de apenas leitura é novamente exibido para demonstrar que é apenas um wrapper para a lista original.
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
Observações
Para evitar quaisquer modificações no List<T> objeto, expõe-o apenas através deste invólucro. Um ReadOnlyCollection<T> objeto não expõe métodos que modificam a coleção. No entanto, se forem feitas alterações ao objeto subjacente List<T> , a coleção de apenas leitura reflete essas alterações.
Este método é uma operação O(1).
