Classe List<T>

List<T> la classe è l'equivalente generico di ArrayList classe. implementa IList<T> interfaccia generica utilizzando una matrice le cui dimensioni sono incrementate in modo dinamico in base alle esigenze.

List<T> la classe utilizza sia un operatore di uguaglianza che un operatore di confronto ordine.

• metodi come Contains, IndexOf, LastIndexOfe Remove utilizzare un operatore di uguaglianza per gli elementi di elenco. L'operatore di uguaglianza predefinito per il tipo T è determinato come segue. se tipo T implementa IEquatable<T> l'interfaccia generica, quindi l'operatore di uguaglianza è Equals(T) metodo dell'interfaccia, in caso contrario, l'operatore di uguaglianza predefinito è Object.Equals(Object).

• metodi come BinarySearch e Sort utilizzare un operatore di confronto ordine per gli elementi di elenco. L'operatore di confronto predefinito per il tipo T è determinato come segue. se tipo T implementa IComparable<T> l'interfaccia generica, quindi l'operatore di confronto predefinito è CompareTo(T) metodo dell'interfaccia, in caso contrario, se tipo T implementa il metodo non generico IComparable collegare, quindi l'operatore di confronto predefinito è CompareTo(Object) metodo dell'interfaccia. se tipo T non implementa nessuna interfaccia, non esiste alcun operatore di confronto predefinito e un operatore di confronto o un delegato di confronto deve essere specificato in modo esplicito.

List<T> non è sempre ordinato. È necessario ordinare List<T> prima di eseguire operazioni (ad esempio BinarySearch) che richiede List<T> per essere ordinato.

Gli elementi in questa raccolta è possibile accedere utilizzando un intero. Gli indici in questa raccolta in base zero.

per molto grande List<T> oggetti, è possibile aumentare la capacità massima di 2 miliardi di elementi in un sistema a 64 bit impostando enabled attributo " gcAllowVeryLargeObjects elemento di configurazione su true nell'ambiente di runtime.

List<T> accetta null come valore valido per i tipi di riferimento e consente elementi duplicati.

Considerazioni sulle prestazioni

Nell'esempio di codice seguente vengono illustrati diversi metodi e proprietà di List<T> classe generica di stringa. (Per un esempio di un oggetto List<T> i tipi complessi, vedere Contains metodo).

Il costruttore predefinito viene utilizzato per creare un elenco di stringhe con la capacità predefinita. Capacity la proprietà consente di visualizzare quindi Add il metodo viene utilizzato per aggiungere altri elementi. Vengono elencati gli elementi e Capacity la proprietà verrà visualizzato nuovamente, con Count proprietà, indicare che la capacità è stata ampliata in base alle necessità.

Contains il metodo viene utilizzato per verificare la presenza di un elemento nell'elenco, Insert il metodo viene utilizzato per inserire un nuovo elemento nell'elenco e il contenuto dell'elenco viene visualizzato di nuovo.

l'impostazione predefinita Item la proprietà è l'indicizzatore (in c#) per recuperare un elemento, Remove il metodo viene utilizzato per rimuovere la prima istanza dell'elemento duplicato aggiunto in precedenza e il contenuto visualizzato nuovamente. Remove il metodo elimina sempre la prima istanza rilevato.

TrimExcess il metodo viene utilizzato per ridurre la possibilità di corrispondere al conteggio e Capacity e Count le proprietà di. Se la capacità inutilizzata fosse stata meno di 10 percento della capacità totale, l'elenco non sarebbe stato ridimensionato.

Infine, Clear il metodo viene utilizzato per rimuovere tutti gli elementi dall'elenco e Capacity e Count le proprietà di.

using System;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        List<string> dinosaurs = new List<string>();

        Console.WriteLine("\nCapacity: {0}", dinosaurs.Capacity);

        dinosaurs.Add("Tyrannosaurus");
        dinosaurs.Add("Amargasaurus");
        dinosaurs.Add("Mamenchisaurus");
        dinosaurs.Add("Deinonychus");
        dinosaurs.Add("Compsognathus");

        Console.WriteLine();
        foreach(string dinosaur in dinosaurs)
        {
            Console.WriteLine(dinosaur);
        }

        Console.WriteLine("\nCapacity: {0}", dinosaurs.Capacity);
        Console.WriteLine("Count: {0}", dinosaurs.Count);

        Console.WriteLine("\nContains(\"Deinonychus\"): {0}",
            dinosaurs.Contains("Deinonychus"));

        Console.WriteLine("\nInsert(2, \"Compsognathus\")");
        dinosaurs.Insert(2, "Compsognathus");

        Console.WriteLine();
        foreach(string dinosaur in dinosaurs)
        {
            Console.WriteLine(dinosaur);
        }

        Console.WriteLine("\ndinosaurs[3]: {0}", dinosaurs[3]);

        Console.WriteLine("\nRemove(\"Compsognathus\")");
        dinosaurs.Remove("Compsognathus");

        Console.WriteLine();
        foreach(string dinosaur in dinosaurs)
        {
            Console.WriteLine(dinosaur);
        }

        dinosaurs.TrimExcess();
        Console.WriteLine("\nTrimExcess()");
        Console.WriteLine("Capacity: {0}", dinosaurs.Capacity);
        Console.WriteLine("Count: {0}", dinosaurs.Count);

        dinosaurs.Clear();
        Console.WriteLine("\nClear()");
        Console.WriteLine("Capacity: {0}", dinosaurs.Capacity);
        Console.WriteLine("Count: {0}", dinosaurs.Count);
    }
}

/* This code example produces the following output:

Capacity: 0

Tyrannosaurus
Amargasaurus
Mamenchisaurus
Deinonychus
Compsognathus

Capacity: 8
Count: 5

Contains("Deinonychus"): True

Insert(2, "Compsognathus")

Tyrannosaurus
Amargasaurus
Compsognathus
Mamenchisaurus
Deinonychus
Compsognathus

dinosaurs[3]: Mamenchisaurus

Remove("Compsognathus")

Tyrannosaurus
Amargasaurus
Mamenchisaurus
Deinonychus
Compsognathus

TrimExcess()
Capacity: 5
Count: 5

Clear()
Capacity: 5
Count: 0
 */

.NET Framework

.NET Framework Client Profile

Libreria di classi portabile

.NET per applicazioni Windows Store

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (ruoli di base del server non supportati), Windows Server 2008 R2 (ruoli di base del server supportati con SP1 o versione successiva, Itanium non supportato)

Statico pubblicaShared in Visual Basic) i membri di questo tipo sono thread-safe. alcuni membri di istanza non sono garantiti per essere thread-safe.

In List<T> può supportare i reader più elementi, purché la raccolta non viene modificata. L'enumerazione in una raccolta non è di per sé thread-safe. Nei rari casi in cui un'enumerazione è contende con uno o più accesso in scrittura, l'unico modo per garantire il thread safety è di bloccare la raccolta durante l'intera enumerazione. Per consentire la raccolta da parte di più thread per la lettura e la scrittura, è necessario implementare diventi proprietaria della sincronizzazione.

Riferimenti

Altre risorse