List<T>.TrimExcess Methode

Definition

Namespace:

System.Collections.Generic

Assembly:

System.Collections.dll

Quelle:

List.cs

Legt die Kapazität auf die Anzahl der tatsächlich in der List<T> befindlichen Elemente fest, sofern diese Anzahl unter dem Schwellenwert liegt.

C#

public void TrimExcess ();

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie die Kapazität und Anzahl eines List<T> -Objekts überprüfen, das ein einfaches Geschäftsobjekt enthält, und veranschaulicht die Verwendung der TrimExcess -Methode zum Entfernen zusätzlicher Kapazität.

C#

using System;
using System.Collections.Generic;
// Simple business object. A PartId is used to identify a part
// but the part name be different for the same Id.
public class Part : IEquatable<Part>
{
    public string PartName { get; set; }
    public int PartId { get; set; }
    public override string ToString()
    {
        return "ID: " + PartId + "   Name: " + PartName;
    }
    public override bool Equals(object obj)
    {
        if (obj == null) return false;
        Part objAsPart = obj as Part;
        if (objAsPart == null) return false;
        else return Equals(objAsPart);
    }
    public override int GetHashCode()
    {
        return base.GetHashCode();
    }
    public bool Equals(Part other)
    {
        if (other == null) return false;
        return (this.PartId.Equals(other.PartId));
    }
    // Should also override == and != operators.
}
public class Example
{

    public static void Main()
    {
        List<Part> parts = new List<Part>();

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

        parts.Add(new Part() { PartName = "crank arm", PartId = 1234 });
        parts.Add(new Part() { PartName = "chain ring", PartId = 1334 });
        parts.Add(new Part() { PartName = "seat", PartId = 1434 });
        parts.Add(new Part() { PartName = "cassette", PartId = 1534 });
        parts.Add(new Part() { PartName = "shift lever", PartId = 1634 }); ;

        Console.WriteLine();
        foreach (Part aPart in parts)
        {
            Console.WriteLine(aPart);
        }

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

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

        parts.Clear();
        Console.WriteLine("\nClear()");
        Console.WriteLine("Capacity: {0}", parts.Capacity);
        Console.WriteLine("Count: {0}", parts.Count);
    }
    /*
     This code example produces the following output.
            Capacity: 0

            ID: 1234   Name: crank arm
            ID: 1334   Name: chain ring
            ID: 1434   Name: seat
            ID: 1534   Name: cassette
            ID: 1634   Name: shift lever

            Capacity: 8
            Count: 5

            TrimExcess()
            Capacity: 5
            Count: 5

            Clear()
            Capacity: 5
            Count: 0
     */
}

Das folgende Beispiel veranschaulicht die TrimExcess Methode. Mehrere Eigenschaften und Methoden der List<T> -Klasse werden zum Hinzufügen, Einfügen und Entfernen von Elementen aus einer Liste von Zeichenfolgen verwendet. Anschließend wird die TrimExcess -Methode verwendet, um die Kapazität für die Übereinstimmung mit der Anzahl zu verringern, und die Capacity Eigenschaften und Count werden angezeigt. Wenn die nicht verwendete Kapazität weniger als 10 Prozent der Gesamtkapazität betragen hätte, wäre die Größe der Liste nicht geändert worden. Schließlich wird der Inhalt der Liste gelöscht.

C#

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);
}

// Shows accessing the list using the Item property.
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
 */

Hinweise

Diese Methode kann verwendet werden, um den Arbeitsspeicheraufwand einer Sammlung zu minimieren, wenn der Auflistung keine neuen Elemente hinzugefügt werden. Die Kosten für die Neuzuweisung und das Kopieren eines großen List<T> können jedoch erheblich sein, sodass die TrimExcess Methode nichts bewirkt, wenn die Liste mehr als 90 Prozent der Kapazität aufweist. Dadurch wird vermieden, dass für einen relativ geringen Gewinn große Umschichtungskosten anfallen.

Hinweis

Der aktuelle Schwellenwert von 90 Prozent kann sich in zukünftigen Releases ändern.

Bei dieser Methode handelt es sich um einen O(n)-Vorgang, wobei n für steht Count.

Um einen List<T> auf den Anfangszustand zurückzusetzen, rufen Sie die Clear -Methode auf, bevor Sie die TrimExcess -Methode aufrufen. Durch Das Kürzen eines leeren List<T> wird die Kapazität von List<T> auf die Standardkapazität festgelegt.

Die Kapazität kann auch mithilfe der Capacity -Eigenschaft festgelegt werden.

Gilt für:

Weitere Informationen

• Clear()
• Capacity
• Count