ImmutableList<T> Osztály

Definíció

Névtér:

System.Collections.Immutable

Szerelvény:

System.Collections.Immutable.dll

Csomag:

System.Collections.Immutable v11.0.0-preview.7.26381.103

Forrás:

ImmutableList_1.cs

Nem módosítható listát jelöl, amely az index által elérhető objektumok erősen gépelt listája.

generic <typename T>
public ref class ImmutableList sealed : System::Collections::Generic::ICollection<T>, System::Collections::Generic::IEnumerable<T>, System::Collections::Generic::IList<T>, System::Collections::Generic::IReadOnlyCollection<T>, System::Collections::Generic::IReadOnlyList<T>, System::Collections::IList, System::Collections::Immutable::IImmutableList<T>

public sealed class ImmutableList<T> : System.Collections.Generic.ICollection<T>, System.Collections.Generic.IEnumerable<T>, System.Collections.Generic.IList<T>, System.Collections.Generic.IReadOnlyCollection<T>, System.Collections.Generic.IReadOnlyList<T>, System.Collections.IList, System.Collections.Immutable.IImmutableList<T>

type ImmutableList<'T> = class
    interface IImmutableList<'T>
    interface IReadOnlyList<'T>
    interface seq<'T>
    interface IEnumerable
    interface IReadOnlyCollection<'T>
    interface IList<'T>
    interface ICollection<'T>
    interface IList
    interface ICollection

Public NotInheritable Class ImmutableList(Of T)
Implements ICollection(Of T), IEnumerable(Of T), IImmutableList(Of T), IList, IList(Of T), IReadOnlyCollection(Of T), IReadOnlyList(Of T)

Típusparaméterek

T

A lista elemeinek típusa.

Öröklődés

Object

ImmutableList<T>

Megvalósítás

ICollection<T> IEnumerable<T> IList<T> IReadOnlyCollection<T> IReadOnlyList<T> ICollection IEnumerable IList IImmutableList<T>

Példák

Ez a példa bemutatja, hogyan hozhat létre nem módosítható listát, és hogyan iterálhat a benne lévő elemeken:

// Create an immutable list of strings
ImmutableList<string> colors = ImmutableList.Create("Red", "Green", "Blue");

// Iterate over all items in the list and print them
foreach (string s in colors)
{
    Console.WriteLine(s);
}

/* Example output:
 Red
 Green
 Blue
 */

Ez a példa bemutatja, hogyan hozhat létre új nem módosítható listát elemek hozzáadásával és eltávolításával az eredeti listából:

// Create an immutable list of strings
ImmutableList<string> colors = ImmutableList.Create("Red", "Green", "Blue");

// Create a new immutable list by adding and removing items from the original list
ImmutableList<string> colorsModified = colors.RemoveAt(1).Add("Orange");

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

/* Example output:
 Red
 Blue
 Orange
 */

Megjegyzések

ImmutableList<T> nincs nyilvános konstruktora; első lépésként egy üreset ImmutableList<T> kell beolvasni a ImmutableList<T>.Emptykövetkezővel: . Ezután meghívhat metódusokat, például Add és AddRange, hogy feltöltse a gyűjteményt. Vegye figyelembe, hogy ezek a metódusok egy új objektumot adnak vissza. Ha nem módosítható listából ad hozzá vagy távolít el elemeket, az eredeti lista másolata a hozzáadott vagy eltávolított elemeket tartalmazza, és az eredeti lista változatlan marad.

Mezők

Name	Description
Empty	Üres nem módosítható listát kap.

Tulajdonságok

Name	Description
Count	Lekéri a listában szereplő elemek számát.
IsEmpty	Olyan értéket kap, amely jelzi, hogy a lista üres-e.
Item[Int32]	Lekéri az elemet a lista megadott indexében.

Metódusok

Name	Description
Add(T)	Hozzáadja a megadott objektumot a nem módosítható lista végéhez.
AddRange(IEnumerable<T>)	Hozzáadja a megadott gyűjtemény elemeit a nem módosítható lista végéhez.
BinarySearch(Int32, Int32, T, IComparer<T>)	A megadott összehasonlító használatával keres egy elem sorba rendezett listájában egy elemtartományt, és visszaadja az elem nulla alapú indexét.
BinarySearch(T, IComparer<T>)	A megadott összehasonlító használatával a teljes rendezett listában keres egy elemet, és visszaadja az elem nulla alapú indexét.
BinarySearch(T)	Megkeresi a teljes rendezési listát egy elemben az alapértelmezett összehasonlító használatával, és visszaadja az elem nulla alapú indexét.
Clear()	Eltávolítja az összes elemet a nem módosítható listából.
Contains(T)	Meghatározza, hogy ez a nem módosítható lista tartalmazza-e a megadott értéket.
ConvertAll<TOutput>(Func<T,TOutput>)	Az aktuális nem módosítható lista elemeit egy másik típussá alakítja át, és visszaadja a konvertált elemeket tartalmazó listát.
CopyTo(Int32, T[], Int32, Int32)	A nem módosítható lista elemeinek tartományát átmásolja egy kompatibilis egydimenziós tömbbe a céltömb megadott indexétől kezdve.
CopyTo(T[], Int32)	A teljes nem módosítható listát átmásolja egy kompatibilis egydimenziós tömbbe a céltömb megadott indexétől kezdve.
CopyTo(T[])	A teljes nem módosítható listát átmásolja egy kompatibilis egydimenziós tömbbe a céltömb elejétől kezdve.
Exists(Predicate<T>)	Meghatározza, hogy a nem módosítható lista tartalmaz-e olyan elemeket, amelyek megfelelnek a megadott predikátum által meghatározott feltételeknek.
Find(Predicate<T>)	Olyan elemet keres, amely megfelel a megadott predikátum által meghatározott feltételeknek, és visszaadja az első előfordulást a teljes nem módosítható listában.
FindAll(Predicate<T>)	Lekéri a megadott predikátum által meghatározott feltételeknek megfelelő összes elemet.
FindIndex(Int32, Int32, Predicate<T>)	Olyan elemet keres, amely megfelel a megadott predikátum által meghatározott feltételeknek, és visszaadja az első előfordulás nulla alapú indexét a nem módosítható lista azon elemeinek tartományán belül, amelyek a megadott indexnél kezdődnek, és a megadott számú elemet tartalmazzák.
FindIndex(Int32, Predicate<T>)	Olyan elemet keres, amely megfelel a megadott predikátum által meghatározott feltételeknek, és visszaadja az első előfordulás nulla alapú indexét a módosíthatatlan lista elemeinek tartományán belül, amely a megadott indextől az utolsó elemig terjed.
FindIndex(Predicate<T>)	Olyan elemet keres, amely megfelel a megadott predikátum által meghatározott feltételeknek, és az első előfordulás nulla alapú indexét adja vissza a teljes nem módosítható listában.
FindLast(Predicate<T>)	Olyan elemet keres, amely megfelel a megadott predikátum által meghatározott feltételeknek, és az utolsó előfordulást adja vissza a teljes nem módosítható listában.
FindLastIndex(Int32, Int32, Predicate<T>)	Olyan elemet keres, amely megfelel a megadott predikátum által meghatározott feltételeknek, és visszaadja az utolsó előfordulás nulla alapú indexét a módosíthatatlan lista azon elemeinek tartományán belül, amelyek a megadott számú elemet tartalmazzák, és a megadott indexben végződnek.
FindLastIndex(Int32, Predicate<T>)	Olyan elemet keres, amely megfelel a megadott predikátum által meghatározott feltételeknek, és visszaadja az utolsó előfordulás nulla alapú indexét a módosíthatatlan lista elemeinek tartományán belül, amely az első elemtől a megadott indexig terjed.
FindLastIndex(Predicate<T>)	Olyan elemet keres, amely megfelel a megadott predikátum által meghatározott feltételeknek, és az utolsó előfordulás nulla alapú indexét adja vissza a teljes nem módosítható listában.
ForEach(Action<T>)	Végrehajtja a megadott műveletet a nem módosítható lista minden elemén.
GetEnumerator()	Egy enumerátort ad vissza, amely a nem módosítható listában iterál.
GetRange(Int32, Int32)	A forrás nem módosítható listájában lévő elemek egy tartományának sekély másolatát hozza létre.
IndexOf(T, Int32, Int32, IEqualityComparer<T>)	Megkeresi a megadott objektumot, és visszaadja az első előfordulás nulla alapú indexét a lista azon elemeinek tartományán belül, amelyek a megadott indexnél kezdődnek, és a megadott számú elemet tartalmazzák.
IndexOf(T)	Megkeresi a megadott objektumot, és az első előfordulás nulla alapú indexét adja vissza a teljes nem módosítható listában.
Insert(Int32, T)	Beszúrja a megadott objektumot a megadott index nem módosítható listájába.
InsertRange(Int32, IEnumerable<T>)	Beszúrja a gyűjtemény elemeit a megadott index nem módosítható listájába.
ItemRef(Int32)	Beolvas egy írásvédett hivatkozást a készlet adott elemére.index
LastIndexOf(T, Int32, Int32, IEqualityComparer<T>)	Megkeresi a megadott objektumot, és visszaadja az utolsó előfordulás nulla alapú indexét a lista azon elemeinek tartományán belül, amelyek a megadott számú elemet tartalmazzák, és a megadott indexben végződnek.
Remove(T, IEqualityComparer<T>)	Eltávolítja az objektum első olyan előfordulását, amely megfelel a megadott értéknek ebből a nem módosítható listából.
Remove(T)	Eltávolítja a megadott objektum első előfordulását ebből a nem módosítható listából.
RemoveAll(Predicate<T>)	Eltávolítja az összes olyan elemet, amely megfelel a megadott predikátum által meghatározott feltételeknek.
RemoveAt(Int32)	Eltávolítja az elemet a megadott indexből.
RemoveRange(IEnumerable<T>, IEqualityComparer<T>)	Eltávolítja a megadott értékeket ebből a listából.
RemoveRange(IEnumerable<T>)	Eltávolít egy sor elemet ebből a nem módosítható listából.
RemoveRange(Int32, Int32)	Eltávolít egy elemtartományt a megadott indexből kiindulva, amely a megadott számú elemet tartalmazza, ebből a nem módosítható listából.
Replace(T, T, IEqualityComparer<T>)	A nem módosítható lista megadott elemét lecseréli egy új elemre.
Replace(T, T)	A nem módosítható lista megadott elemét lecseréli egy új elemre.
Reverse()	Megfordítja az elemek sorrendjét a teljes nem módosítható listában.
Reverse(Int32, Int32)	Megfordítja a nem módosítható lista megadott tartományában lévő elemek sorrendjét.
SetItem(Int32, T)	A nem módosítható lista egy adott helyén lévő elemet lecseréli a megadott elemre.
Sort()	Az alapértelmezett összehasonlító használatával rendezi a teljes nem módosítható lista elemeit.
Sort(Comparison<T>)	A teljes nem módosítható lista elemeit a megadott összehasonlító használatával rendezi.
Sort(IComparer<T>)	A teljes nem módosítható lista elemeit a megadott összehasonlító használatával rendezi.
Sort(Int32, Int32, IComparer<T>)	A nem módosítható lista elemeinek tartományát rendezi a megadott összehasonlító használatával.
ToBuilder()	Olyan listát hoz létre, amely ugyanazzal a tartalommal rendelkezik, mint ez a lista, és hatékonyan mutálható több művelet között standard mutable interfészek használatával.
TrueForAll(Predicate<T>)	Meghatározza, hogy a nem módosítható lista minden eleme megfelel-e a megadott predikátum által meghatározott feltételeknek.

Explicit interfész-implementációk

Name	Description
ICollection.CopyTo(Array, Int32)	A teljes nem módosítható listát átmásolja egy kompatibilis egydimenziós tömbbe a megadott tömbindextől kezdve.
ICollection.IsSynchronized	Ez a típus nem módosítható, ezért mindig szálbiztos. Tekintse meg a ICollection felületet.
ICollection.SyncRoot	Lásd a(z) ICollection.
ICollection<T>.Add(T)	Hozzáadja a megadott elemet a nem módosítható listához.
ICollection<T>.Clear()	Eltávolítja az összes elemet a nem módosítható listából.
ICollection<T>.IsReadOnly	Beolvas egy értéket, amely jelzi, hogy az ICollection<T> írásvédett-e.
ICollection<T>.Remove(T)	Eltávolítja egy adott objektum első előfordulását a nem módosítható listából.
IEnumerable.GetEnumerator()	Egy enumerátort ad vissza, amely a nem módosítható listában iterál.
IEnumerable<T>.GetEnumerator()	Egy enumerátort ad vissza, amely a nem módosítható listában iterál.
IImmutableList<T>.Add(T)	Hozzáadja a megadott értéket ehhez a nem módosítható listához.
IImmutableList<T>.AddRange(IEnumerable<T>)	Hozzáadja a megadott értékeket ehhez a nem módosítható listához.
IImmutableList<T>.Clear()	Egy üres listát kér le, amely a jelen példányhoz hasonló rendezési és rendezési szemantikával rendelkezik.
IImmutableList<T>.Insert(Int32, T)	Beszúrja a megadott elemet a megadott indexbe a nem módosítható listában.
IImmutableList<T>.InsertRange(Int32, IEnumerable<T>)	Beszúrja a megadott elemeket a megadott indexbe a nem módosítható listában.
IImmutableList<T>.Remove(T, IEqualityComparer<T>)	Eltávolítja a megadott értékkel rendelkező elemet a listából.
IImmutableList<T>.RemoveAll(Predicate<T>)	Eltávolítja az összes olyan elemet, amely megfelel a megadott predikátum által meghatározott feltételeknek.
IImmutableList<T>.RemoveAt(Int32)	Eltávolítja az elemet a nem módosítható lista megadott indexéből.
IImmutableList<T>.RemoveRange(IEnumerable<T>, IEqualityComparer<T>)	Eltávolít egy olyan elemtartományt ebből a nem módosítható listából, amely megfelel a megadott elemeknek.
IImmutableList<T>.RemoveRange(Int32, Int32)	Eltávolítja a megadott számú elemet a listából a megadott helyen.
IImmutableList<T>.Replace(T, T, IEqualityComparer<T>)	A lista egy elemét lecseréli a megadott elemre.
IImmutableList<T>.SetItem(Int32, T)	Egy adott helyen lévő listaelem lecserélése a megadott elemre.
IList.Add(Object)	Hozzáad egy elemet a nem módosítható listához.
IList.Clear()	Eltávolítja az összes elemet a nem módosítható listából.
IList.Contains(Object)	Meghatározza, hogy a nem módosítható lista tartalmaz-e egy adott értéket.
IList.IndexOf(Object)	Meghatározza egy adott elem indexét a nem módosítható listában.
IList.Insert(Int32, Object)	Elemet szúr be a megadott index nem módosítható listájába.
IList.IsFixedSize	Egy értéket kap, amely jelzi, hogy a IList méret rögzített-e.
IList.IsReadOnly	Beolvas egy értéket, amely jelzi, hogy az ICollection<T> írásvédett-e.
IList.Item[Int32]	Lekéri vagy beállítja a Object megadott indexet.
IList.Remove(Object)	Eltávolítja egy adott objektum első előfordulását a nem módosítható listából.
IList.RemoveAt(Int32)	Eltávolítja az elemet a nem módosítható lista megadott indexéből.
IList<T>.Insert(Int32, T)	Objektum beszúrása a nem módosítható listába a megadott indexen.
IList<T>.Item[Int32]	Lekéri vagy beállítja az értéket a megadott indexen.
IList<T>.RemoveAt(Int32)	Eltávolítja az értéket a megadott indexből.

Bővítő metódusok

Name	Description
IndexOf<T>(IImmutableList<T>, T, IEqualityComparer<T>)	Megkeresi a megadott objektumot, és a listában az első előfordulás nulla alapú indexét adja vissza.
IndexOf<T>(IImmutableList<T>, T, Int32, Int32)	Megkeresi a megadott objektumot, és visszaadja az első előfordulás nullaalapú indexét a módosíthatatlan lista elemeinek tartományán belül, amely a megadott indextől az utolsó elemig terjed.
IndexOf<T>(IImmutableList<T>, T, Int32)	Megkeresi a megadott objektumot, és visszaadja az első előfordulás nullaalapú indexét a módosíthatatlan lista elemeinek tartományán belül, amely a megadott indextől az utolsó elemig terjed.
IndexOf<T>(IImmutableList<T>, T)	Megkeresi a megadott objektumot, és a listában az első előfordulás nulla alapú indexét adja vissza.
LastIndexOf<T>(IImmutableList<T>, T, IEqualityComparer<T>)	Megkeresi a megadott objektumot, és az utolsó előfordulás nulla alapú indexét adja vissza a teljes nem módosítható listában.
LastIndexOf<T>(IImmutableList<T>, T, Int32, Int32)	Megkeresi a megadott objektumot, és visszaadja az utolsó előfordulás nulla alapú indexét a módosíthatatlan lista elemeinek tartományán belül, amely az első elemtől a megadott indexig terjed.
LastIndexOf<T>(IImmutableList<T>, T, Int32)	Megkeresi a megadott objektumot, és visszaadja az utolsó előfordulás nulla alapú indexét a módosíthatatlan lista elemeinek tartományán belül, amely az első elemtől a megadott indexig terjed.
LastIndexOf<T>(IImmutableList<T>, T)	Megkeresi a megadott objektumot, és az utolsó előfordulás nulla alapú indexét adja vissza a teljes nem módosítható listában.
Remove<T>(IImmutableList<T>, T)	Eltávolítja a megadott értéket a listából.
RemoveRange<T>(IImmutableList<T>, IEnumerable<T>)	Eltávolítja a megadott értékeket ebből a listából.
Replace<T>(IImmutableList<T>, T, T)	A lista első egyenlőségelemét lecseréli a megadott elemre.
ToAsyncEnumerable<TSource>(IEnumerable<TSource>)	Átalakítja az egyiket IEnumerable<T>IAsyncEnumerable<T>.
ToFrozenDictionary<TSource,TKey,TElement>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>)	Létrehoz egy FrozenDictionary<TKey,TValue>IEnumerable<T> megadott kulcsválasztó és elemválasztó függvény alapján.
ToFrozenDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	Létrehoz egy FrozenDictionary<TKey,TValue> megadott kulcsválasztó függvényt IEnumerable<T> .
ToFrozenSet<T>(IEnumerable<T>, IEqualityComparer<T>)	Létrehoz egy FrozenSet<T> értéket a megadott értékekkel.
ToImmutableArray<TSource>(IEnumerable<TSource>)	Módosíthatatlan tömböt hoz létre a megadott gyűjteményből.
ToImmutableDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IEqualityComparer<TKey>, IEqualityComparer<TValue>)	Számba és átalakít egy sorozatot, és a megadott kulcs- és érték-összehasonlítók használatával módosíthatatlan szótárt hoz létre a tartalmából.
ToImmutableDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IEqualityComparer<TKey>)	Számba és átalakít egy sorozatot, és a megadott kulcs-összehasonlító használatával módosíthatatlan szótárt hoz létre a tartalmából.
ToImmutableDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>)	Számbavétele és átalakítása egy sorozat, és létrehoz egy nem módosítható szótár a tartalmát.
ToImmutableDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	Egy szekvencia valamilyen átalakításán alapuló nem módosítható szótárt hoz létre.
ToImmutableDictionary<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)	Egy nem módosítható szótárat hoz létre egy meglévő elemgyűjteményből, amely egy átalakítási függvényt alkalmaz a forráskulcsokra.
ToImmutableHashSet<TSource>(IEnumerable<TSource>, IEqualityComparer<TSource>)	Számba veszi a sorozatot, módosíthatatlan kivonatkészletet hoz létre a tartalmából, és a megadott egyenlőség-összehasonlítót használja a készlettípushoz.
ToImmutableHashSet<TSource>(IEnumerable<TSource>)	Számba ad egy sorozatot, és a tartalma nem módosítható kivonatkészletet hoz létre.
ToImmutableList<TSource>(IEnumerable<TSource>)	Számba ad egy sorozatot, és megváltoztathatatlan listát hoz létre annak tartalmáról.
ToImmutableSortedDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IComparer<TKey>, IEqualityComparer<TValue>)	Számba és átalakít egy sorozatot, és a megadott kulcs- és érték-összehasonlítók használatával módosíthatatlan rendezési szótárt hoz létre a tartalmaiból.
ToImmutableSortedDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>, IComparer<TKey>)	Számbavesz és átalakít egy sorozatot, és a megadott kulcs-összehasonlító használatával módosíthatatlan rendezési szótárt hoz létre a tartalmaiból.
ToImmutableSortedDictionary<TSource,TKey,TValue>(IEnumerable<TSource>, Func<TSource,TKey>, Func<TSource,TValue>)	Számbavétele és átalakítása egy sorozat, és létrehoz egy nem módosítható rendezett szótár a tartalmát.
ToImmutableSortedSet<TSource>(IEnumerable<TSource>, IComparer<TSource>)	Számba veszi a sorozatot, megváltoztathatatlan rendezési halmazt hoz létre, és a megadott összehasonlítót használja.
ToImmutableSortedSet<TSource>(IEnumerable<TSource>)	Számba ad egy sorozatot, és megváltoztathatatlan rendezésű halmazt hoz létre annak tartalmából.

Szálbiztonság

Ez a típus szálbiztos.