NameValueCollection.Item[String] Propriété

Définition

Obtient ou définit l'entrée spécifiée du NameValueCollection.Gets or sets the specified entry of the NameValueCollection.

Surcharges

Item[Int32]

Obtient l'entrée à l'index spécifié du NameValueCollection.Gets the entry at the specified index of the NameValueCollection.

Item[String]

Obtient ou définit l'entrée dans le NameValueCollection avec la clé spécifiée.Gets or sets the entry with the specified key in the NameValueCollection.

Item[Int32]

Obtient l'entrée à l'index spécifié du NameValueCollection.Gets the entry at the specified index of the 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 à rechercher dans la collection.The zero-based index of the entry to locate in the collection.

Valeur de propriété

String qui contient la liste avec la virgule comme séparateur des valeurs à l'index spécifié de la collection.A String that contains the comma-separated list of values at the specified index of the collection.

Exceptions

index est en dehors de la plage valide des index pour la collection.index is outside the valid range of indexes for the collection.

Remarques

Cette propriété permet d’accéder à un élément spécifique de la collection à l’aide de la syntaxe suivante : myCollection[index].This property provides the ability to access a specific element in the collection by using the following syntax: myCollection[index].

Cette propriété ne peut pas être définie.This property cannot be set. Pour définir la valeur à un index spécifié, utilisez Item[GetKey(index)].To set the value at a specified index, use Item[GetKey(index)].

Le C# langage utilise le mot clé This pour définir les indexeurs au lieu d’implémenter la propriété Item[String].The C# language uses the this keyword to define the indexers instead of implementing the Item[String] property. Visual Basic implémente Item[String] comme propriété par défaut, ce qui fournit les mêmes fonctionnalités d’indexation.Visual Basic implements Item[String] as a default property, which provides the same indexing functionality.

La récupération des valeurs à l’index spécifié est une opération O (n), où n est le nombre de valeurs.Retrieving the values at the specified index is an O(n) operation, where n is the number of values.

Voir aussi

Item[String]

Obtient ou définit l'entrée dans le NameValueCollection avec la clé spécifiée.Gets or sets the entry with the specified key in the 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 à rechercher.The String key of the entry to locate. La clé peut être null.The key can be null.

Valeur de propriété

String qui contient la liste avec la virgule comme séparateur des valeurs associées à la clé spécifiée, si elle existe ; sinon, null.A String that contains the comma-separated list of values associated with the specified key, if found; otherwise, null.

Exceptions

La collection est en lecture seule et l’opération tente de modifier la collection.The collection is read-only and the operation attempts to modify the collection.

Remarques

Cette propriété permet d’accéder à un élément spécifique de la collection à l’aide de la syntaxe suivante : myCollection[name].This property provides the ability to access a specific element in the collection by using the following syntax: myCollection[name].

Si la clé spécifiée existe déjà dans la collection, la définition de cette propriété remplace la liste de valeurs existante par la valeur spécifiée.If the specified key already exists in the collection, setting this property overwrites the existing list of values with the specified value. Pour ajouter la nouvelle valeur à la liste de valeurs existante, utilisez la méthode Add.To append the new value to the existing list of values, use the Add method.

Si la clé spécifiée n’existe pas dans la collection, la définition de cette propriété crée une nouvelle entrée à l’aide de la clé et de la valeur spécifiées.If the specified key does not exist in the collection, setting this property creates a new entry using the specified key and the specified value.

Attention

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 que sa valeur associée est null.This property returns null in the following cases: 1) if the specified key is not found; and 2) if the specified key is found and its associated value is null. Cette propriété ne fait pas la distinction entre les deux cas.This property does not distinguish between the two cases.

Le C# langage utilise le mot clé This pour définir les indexeurs au lieu d’implémenter la propriété Item[String].The C# language uses the this keyword to define the indexers instead of implementing the Item[String] property. Visual Basic implémente Item[String] comme propriété par défaut, ce qui fournit les mêmes fonctionnalités d’indexation.Visual Basic implements Item[String] as a default property, which provides the same indexing functionality.

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 est le nombre de valeurs.Retrieving or setting the values associated with the specified key is an O(n) operation, where n is the number of values.

Voir aussi

S’applique à