List<T>.AsReadOnly Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Retourneert een alleen-lezen ReadOnlyCollection<T> wrapper voor de huidige verzameling.
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)Retouren
Een object dat fungeert als een alleen-lezen wrapper rond de huidige List<T>.
Voorbeelden
In het volgende voorbeeld ziet u de AsReadOnly methode. Er wordt een List<T> tekenreeks met een capaciteit van 4 gemaakt, omdat de uiteindelijke grootte van de lijst precies 4 is. De lijst wordt gevuld met vier tekenreeksen en de AsReadOnly methode wordt gebruikt voor het ophalen van een alleen-lezen IList<T> algemene interface-implementatie die de oorspronkelijke lijst verpakt.
Een element van de oorspronkelijke lijst is ingesteld op 'Coeltrofie' met behulp van de Item[] eigenschap (de indexeerfunctie in C#) en de inhoud van de alleen-lezenlijst wordt opnieuw weergegeven om aan te tonen dat het slechts een wrapper is voor de oorspronkelijke lijst.
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
Opmerkingen
Als u wijzigingen in het List<T> object wilt voorkomen, maakt u het alleen beschikbaar via deze wrapper. Een ReadOnlyCollection<T> object bevat geen methoden waarmee de verzameling wordt gewijzigd. Als er echter wijzigingen worden aangebracht in het onderliggende List<T> object, weerspiegelt de verzameling alleen-lezen deze wijzigingen.
Deze methode is een O(1)-bewerking.