NameValueCollection.Item[] Propriété

Définition

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

Obtient ou définit l’entrée spécifiée du NameValueCollection.

Surcharges

Nom Description
Item[Int32]

Obtient l’entrée à l’index spécifié du NameValueCollection.
Item[String]

Obtient ou définit l’entrée avec la clé spécifiée dans le NameValueCollection.

Item[Int32]

Obtient l’entrée à l’index spécifié du NameValueCollection.

public:
 property System::String ^ default[int] { System::String ^ get(int index); };
public string this[int index] { get; }
member this.Item(int) : string
Default Public ReadOnly Property Item(index As Integer) As String

Paramètres

index
Int32

Index de base zéro de l’entrée à localiser dans la collection.

Valeur de propriété

String

Qui String contient la liste séparée par des virgules des valeurs à l’index spécifié de la collection.

Exceptions

ArgumentOutOfRangeException

index est en dehors de la plage valide d’index pour la collection.

Remarques

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

Cette propriété ne peut pas être définie. Pour définir la valeur à un index spécifié, utilisez Item[GetKey(index)].

Le langage C# utilise ce 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é default qui fournit les mêmes fonctionnalités d’indexation.

La récupération des valeurs à l’index spécifié est une opération O(n), où n se trouve le nombre de valeurs.

Voir aussi

S’applique à

Item[String]

Obtient ou définit l’entrée avec la clé spécifiée dans le NameValueCollection.

public:
 property System::String ^ default[System::String ^] { System::String ^ get(System::String ^ name); void set(System::String ^ name, System::String ^ value); };
public string this[string name] { get; set; }
member this.Item(string) : string with get, set
Default Public Property Item(name As String) As String

Paramètres

name
String

Clé String de l’entrée à localiser. La clé peut être null.

Valeur de propriété

String

Qui String contient la liste séparée par des virgules des valeurs associées à la clé spécifiée, si elle est trouvée ; sinon, null.

Exceptions

NotSupportedException

La collection est en lecture seule et l’opération tente de modifier la collection.

Remarques

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

Si la clé spécifiée existe déjà dans la collection, la définition de cette propriété remplace la liste existante de valeurs par la valeur spécifiée. Pour ajouter la nouvelle valeur à la liste existante de valeurs, utilisez la Add méthode.

Si la clé spécifiée n’existe pas dans la collection, la définition de cette propriété crée une entrée à l’aide de la clé spécifiée et de la valeur spécifiée.

Avertissement

Cette propriété retourne null dans les cas suivants : 1) si la clé spécifiée est introuvable ; et 2) si la clé spécifiée est trouvée et sa valeur associée est null. Cette propriété ne fait pas la distinction entre les deux cas.

Le langage C# utilise ce 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é default qui fournit les mêmes fonctionnalités d’indexation.

La récupération ou la définition des valeurs associées à la clé spécifiée est une opération O(n), où n se trouve le nombre de valeurs.

Voir aussi

S’applique à