Metodo List<T>.Insert
Aggiornamento: novembre 2007
Consente di inserire un elemento in List<T> in corrispondenza dell'indice specificato.
Assembly: mscorlib (in mscorlib.dll)
public final void Insert( int index, T item )
public final function Insert( index : int, item : T )
Parametri
- index
- Tipo: System.Int32
Indice in base zero nel quale deve essere inserito item.
- item
- Tipo: T
Oggetto da inserire. Il valore può essere null per i tipi di riferimento.
Implementa
IList<T>.Insert(Int32, T)| Eccezione | Condizione |
|---|---|
| ArgumentOutOfRangeException | index è minore di 0. -o- index è maggiore di Count . |
List<T> accetta null come valore valido per i tipi di riferimento e consente elementi duplicati.
Se la proprietà Count è già uguale a Capacity, la capacità della classe List<T> viene aumentata riallocando automaticamente la matrice interna e gli elementi esistenti vengono copiati nella nuova matrice prima dell'aggiunta del nuovo elemento.
Se index è uguale a Count, viene aggiunto item alla fine di List<T>.
Questo metodo è un'operazione O(n), dove n è Count.
Nell'esempio di codice riportato di seguito vengono illustrati il metodo Insert insieme a diverse altre proprietà e metodi della classe generica List<T>. Una volta creato l'elenco, vengono aggiunti gli elementi. Mediante il metodo Insert viene inserito un elemento al centro dell'elenco. L'elemento inserito è un duplicato che viene successivamente rimosso mediante il metodo Remove.
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 Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition , Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile per Smartphone, Windows Mobile per Pocket PC, Xbox 360
.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.
Aggiunte alla community
AGGIUNGI
Si desidera partecipare?
