Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

List.Insert-Methode

Hinweis: Diese Methode ist neu in .NET Framework, Version 2.0.

Fügt am angegebenen Index ein Element in die List ein.

Namespace: System.Collections.Generic
Assembly: mscorlib (in mscorlib.dll)

public void Insert (
	int index,
	T item
)
public final void Insert (
	int index, 
	T item
)
public final function Insert (
	index : int, 
	item : T
)

Parameter

index

Der nullbasierte Index, an dem item eingefügt werden soll.

item

Das einzufügende Objekt. Der Wert kann für Verweistypen NULL (Nothing in Visual Basic) sein.

AusnahmetypBedingung

ArgumentOutOfRangeException

index ist kleiner als 0 (null).

– oder –

index ist größer als Count.

List akzeptiert NULL (Nothing in Visual Basic) als gültigen Wert für Verweistypen und lässt doppelte Elemente zu.

Wenn der Wert von Count bereits gleich Capacity ist, wird die Kapazität der List durch automatisches Neureservieren des internen Arrays erhöht, und die vorhandenen Elemente werden in das neue Array kopiert, bevor das neue Element hinzugefügt wird.

Wenn index gleich Count ist, wird das item am Ende der List hinzugefügt.

Diese Methode ist eine O(n)-Operation, wobei n für Count steht.

Im folgenden Codebeispiel werden die Insert-Methode sowie verschiedene andere Eigenschaften und Methoden der generischen List-Klasse veranschaulicht. Nachdem die Liste erstellt wurde, werden Elemente hinzugefügt. Mit der Insert-Methode wird ein Element in die Mitte der Liste eingefügt. Das eingefügte Element ist ein Duplikat, das später mit der Remove-Methode entfernt wird.

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
 */

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

.NET Framework

Unterstützt in: 2.0

.NET Compact Framework

Unterstützt in: 2.0
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
© 2013 Microsoft. Alle Rechte vorbehalten.