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

Définition

Espace de noms:
System.Collections.Generic
Assemblys:
mscorlib.dll, System.Collections.dll
Assembly:
mscorlib.dll
Assembly:
System.Collections.dll
Assembly:
netstandard.dll

Obtient ou définit l’élément à 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 à l’index spécifié.

Implémente

Item[Int32]

Exceptions

ArgumentOutOfRangeException

index est inférieur à 0.

-ou-

index est égal ou supérieur Countà .

Exemples

L’exemple de cette section illustre la Item[] propriété (l’indexeur en C#) et d’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.)

Note

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

Le langage C# utilise le this mot clé pour définir les indexeurs au lieu d’implémenter la Item[] propriété. Visual Basic implémente Item[] en tant que propriété par défaut, 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 planets As New List(Of String)

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

planets.Add("Mercury")
planets.Add("Venus")
planets.Add("Earth")
planets.Add("Mars")
planets.Add("Jupiter")

// 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 & "planets(3): {0}", planets(3))

Remarques

List<T> accepte null comme valeur valide pour les types de 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) ; définir la propriété est également une opération O(1).

S’applique à

Voir aussi