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

Référence

Définition

Espace de noms:: System.Collections.Generic

Assembly:: System.Collections.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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 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, voir AsReadOnly.)

Notes

Visual Basic, C# et C++ ont toutes une syntaxe pour accéder à la Item[] propriété sans utiliser son nom. Au lieu de cela, la variable contenant l’élément 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[] 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).

S’applique à

Voir aussi

Count