List<T>.Item[Int32] Proprietà

Definizione

Spazio dei nomi:

System.Collections.Generic

Assembly:

System.Collections.dll

Origine:

List.cs

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

public:
 property T default[int] { T get(int index); void set(int index, T value); };

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

member this.Item(int) : 'T with get, set

Default Public Property Item(index As Integer) As T

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 0.

-oppure-

index è uguale a o maggiore di Count.

Esempio

L'esempio in questa sezione illustra la Item[] proprietà (l'indicizzatore in C#) e varie altre proprietà e metodi della List<T> classe generica. Dopo aver creato e popolato l'elenco usando il Add metodo , viene recuperato e visualizzato un elemento usando la Item[] proprietà . Per un esempio che usa la Item[] proprietà per impostare il valore di un elemento elenco, vedere AsReadOnly.)

Nota

Visual Basic, C# e C++ dispongono di una sintassi per l'accesso alla Item[] proprietà senza usare il relativo nome. Al contrario, la variabile contenente List<T> viene usata come se fosse una matrice.

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

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

Dim dinosaurs As New List(Of String)

Console.WriteLine(vbLf & "Capacity: {0}", dinosaurs.Capacity)

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

// Shows accessing the list using the Item property.
Console.WriteLine("\ndinosaurs[3]: {0}", dinosaurs[3]);

' Shows how to access the list using the Item property.
Console.WriteLine(vbLf & "dinosaurs(3): {0}", dinosaurs(3))

Commenti

List<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 recupero del valore di questa proprietà è un'operazione O(1); l'impostazione della proprietà è anche un'operazione O(1).

Vedi anche

• Count