List<T>.Item[Int32] Propriété

Définition

Espace de noms:

System.Collections.Generic

Assembly:

System.Collections.dll

Source:

List.cs

Obtient ou définit l'élément au niveau de l'index spécifié.

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

Paramètres

index

Int32

Index de base zéro de l'élément à obtenir ou à définir.

Valeur de propriété

T

Élément au niveau de l'index spécifié.

Implémente

Item[Int32]

Exceptions

ArgumentOutOfRangeException

index est inférieur à 0.

- ou -

index est supérieur ou égal à Count.

Exemples

L’exemple de cette section illustre la Item[] propriété (l’indexeur en C#) et diverses autres propriétés et méthodes de la List<T> classe générique. Une fois la liste créée et remplie à l’aide de la Add méthode , un élément est récupéré et affiché à l’aide de la Item[] propriété . (Pour obtenir un exemple qui utilise la Item[] propriété pour définir la valeur d’un élément de liste, consultez AsReadOnly.)

Notes

Visual Basic, C# et C++ ont tous une syntaxe permettant d’accéder à la Item[] propriété sans utiliser son nom. Au lieu de cela, la variable contenant le List<T> est utilisée comme s’il s’agissait d’un tableau.

Le langage C# utilise le mot clé this pour définir les indexeurs au lieu d'implémenter la propriété Item[]. Visual Basic implémente Item[] comme propriété par défaut, ce qui fournit les mêmes fonctionnalités d'indexation.

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

Remarques

List<T> accepte null comme valeur valide pour les types référence et autorise les éléments en double.

Cette propriété permet d'accéder à un élément spécifique dans la collection à l'aide de la syntaxe suivante : myCollection[index].

La récupération de la valeur de cette propriété est une opération O(1) ; La définition de la propriété est également une opération O(1).

Voir aussi

• Count