Collection<T>.Item[Int32] Proprietà

Definizione

Spazio dei nomi:

System.Collections.ObjectModel

Assembly:

System.Runtime.dll

Origine:

Collection.cs

Ottiene o imposta l'elemento in corrispondenza dell'indice specificato.

C#

public T this[int index] { get; set; }

Parametri

index

Int32

Indice in base zero dell'elemento da ottenere o impostare.

Valore della proprietà

T

Elemento in corrispondenza dell'indice specificato.

Implementazioni

Item[Int32]

Eccezioni

ArgumentOutOfRangeException

index è minore di zero.

-oppure-

index è uguale a o maggiore di Count.

Esempio

Nell'esempio di codice seguente vengono illustrate molte delle proprietà e dei metodi di Collection<T>. L'esempio di codice crea una raccolta di stringhe, usa il Add metodo per aggiungere diverse stringhe, visualizza Counte elenca le stringhe. Nell'esempio viene usato il IndexOf metodo per trovare l'indice di una stringa e il Contains metodo per determinare se una stringa si trova nella raccolta. Nell'esempio viene inserita una stringa usando il Insert metodo e vengono recuperate e impostate stringhe usando la proprietà predefinita Item[] (l'indicizzatore in C#). Nell'esempio vengono rimosse stringhe in base all'identità stringa usando il metodo e l'indice Remove usando il RemoveAt metodo . Infine, il Clear metodo viene usato per cancellare tutte le stringhe dalla raccolta.

C#

using System;
using System.Collections.Generic;
using System.Collections.ObjectModel;

public class Demo
{
    public static void Main()
    {
        Collection<string> dinosaurs = new Collection<string>();

        dinosaurs.Add("Psitticosaurus");
        dinosaurs.Add("Caudipteryx");
        dinosaurs.Add("Compsognathus");
        dinosaurs.Add("Muttaburrasaurus");

        Console.WriteLine("{0} dinosaurs:", dinosaurs.Count);
        Display(dinosaurs);

        Console.WriteLine("\nIndexOf(\"Muttaburrasaurus\"): {0}",
            dinosaurs.IndexOf("Muttaburrasaurus"));

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

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

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

        Console.WriteLine("\ndinosaurs[2] = \"Microraptor\"");
        dinosaurs[2] = "Microraptor";
        Display(dinosaurs);

        Console.WriteLine("\nRemove(\"Microraptor\")");
        dinosaurs.Remove("Microraptor");
        Display(dinosaurs);

        Console.WriteLine("\nRemoveAt(0)");
        dinosaurs.RemoveAt(0);
        Display(dinosaurs);

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

    private static void Display(Collection<string> cs)
    {
        Console.WriteLine();
        foreach( string item in cs )
        {
            Console.WriteLine(item);
        }
    }
}

/* This code example produces the following output:

4 dinosaurs:

Psitticosaurus
Caudipteryx
Compsognathus
Muttaburrasaurus

IndexOf("Muttaburrasaurus"): 3

Contains("Caudipteryx"): True

Insert(2, "Nanotyrannus")

Psitticosaurus
Caudipteryx
Nanotyrannus
Compsognathus
Muttaburrasaurus

dinosaurs[2]: Nanotyrannus

dinosaurs[2] = "Microraptor"

Psitticosaurus
Caudipteryx
Microraptor
Compsognathus
Muttaburrasaurus

Remove("Microraptor")

Psitticosaurus
Caudipteryx
Compsognathus
Muttaburrasaurus

RemoveAt(0)

Caudipteryx
Compsognathus
Muttaburrasaurus

dinosaurs.Clear()
Count: 0
 */

Commenti

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

Questa proprietà consente di accedere a un elemento specifico nella raccolta utilizzando la sintassi seguente: myCollection[index].

Il linguaggio C# usa la parola chiave per definire gli indicizzatori anziché implementare la Item[] proprietà. In Visual Basic la proprietà Item[] viene implementata come predefinita per fornire la stessa funzionalità di indicizzazione.

Il recupero del valore di questa proprietà è un'operazione O(1); l'impostazione della proprietà è anche un'operazione O(1).

Note per gli eredi

Le classi derivate possono eseguire l'override SetItem(Int32, T) per modificare il comportamento dell'impostazione di questa proprietà.

Si applica a

Vedi anche

• Count