NameValueCollection NameValueCollection NameValueCollection NameValueCollection Class

Définition

Représente une collection de clés String et de valeurs String associées accessibles soit par la clé, soit par l'index.Represents a collection of associated String keys and String values that can be accessed either with the key or with the index.

public ref class NameValueCollection : System::Collections::Specialized::NameObjectCollectionBase
[System.Serializable]
public class NameValueCollection : System.Collections.Specialized.NameObjectCollectionBase
type NameValueCollection = class
    inherit NameObjectCollectionBase
Public Class NameValueCollection
Inherits NameObjectCollectionBase
Héritage
Dérivé
Attributs

Exemples

#using <System.dll>

using namespace System;
using namespace System::Collections;
using namespace System::Collections::Specialized;

void PrintKeysAndValues( NameValueCollection^ myCol );
void PrintKeysAndValues2( NameValueCollection^ myCol );

int main()
{
   // Creates and initializes a new NameValueCollection.
   NameValueCollection^ myCol = gcnew NameValueCollection;
   myCol->Add( "red", "rojo" );
   myCol->Add( "green", "verde" );
   myCol->Add( "blue", "azul" );
   myCol->Add( "red", "rouge" );

   // Displays the values in the NameValueCollection in two different ways.
   Console::WriteLine( "Displays the elements using the AllKeys property and the Item (indexer) property:" );
   PrintKeysAndValues( myCol );
   Console::WriteLine( "Displays the elements using GetKey and Get:" );
   PrintKeysAndValues2( myCol );

   // Gets a value either by index or by key.
   Console::WriteLine( "Index 1 contains the value {0}.", myCol[ 1 ] );
   Console::WriteLine( "Key \"red\" has the value {0}.", myCol[ "red" ] );
   Console::WriteLine();

   // Copies the values to a string array and displays the string array.
   array<String^>^myStrArr = gcnew array<String^>(myCol->Count);
   myCol->CopyTo( myStrArr, 0 );
   Console::WriteLine( "The string array contains:" );
   for each ( String^ s in myStrArr )
      Console::WriteLine( "   {0}", s );
   Console::WriteLine();

   // Searches for a key and deletes it.
   myCol->Remove( "green" );
   Console::WriteLine( "The collection contains the following elements after removing \"green\":" );
   PrintKeysAndValues( myCol );

   // Clears the entire collection.
   myCol->Clear();
   Console::WriteLine( "The collection contains the following elements after it is cleared:" );
   PrintKeysAndValues( myCol );
}

void PrintKeysAndValues( NameValueCollection^ myCol )
{
   Console::WriteLine( "   KEY        VALUE" );
   for each ( String^ s in myCol->AllKeys )
      Console::WriteLine( "   {0,-10} {1}", s, myCol[s] );
   Console::WriteLine();
}

void PrintKeysAndValues2( NameValueCollection^ myCol )
{
   Console::WriteLine( "   [INDEX] KEY        VALUE" );
   for ( int i = 0; i < myCol->Count; i++ )
      Console::WriteLine( "   [{0}]     {1,-10} {2}", i, myCol->GetKey( i ), myCol->Get( i ) );
   Console::WriteLine();
}

/*

This code produces the following output.

Displays the elements using the AllKeys property and the Item (indexer) property:
   KEY        VALUE
   red        rojo,rouge
   green      verde
   blue       azul

Displays the elements using GetKey and Get:
   [INDEX] KEY        VALUE
   [0]     red        rojo,rouge
   [1]     green      verde
   [2]     blue       azul

Index 1 contains the value verde.
Key "red" has the value rojo,rouge.

The string array contains:
   rojo,rouge
   verde
   azul

The collection contains the following elements after removing "green":
   KEY        VALUE
   red        rojo,rouge
   blue       azul

The collection contains the following elements after it is cleared:
   KEY        VALUE


*/
using System;
using System.Collections;
using System.Collections.Specialized;

public class SamplesNameValueCollection  {

   public static void Main()  {

      // Creates and initializes a new NameValueCollection.
      NameValueCollection myCol = new NameValueCollection();
      myCol.Add( "red", "rojo" );
      myCol.Add( "green", "verde" );
      myCol.Add( "blue", "azul" );
      myCol.Add( "red", "rouge" );

      // Displays the values in the NameValueCollection in two different ways.
      Console.WriteLine( "Displays the elements using the AllKeys property and the Item (indexer) property:" );
      PrintKeysAndValues( myCol );
      Console.WriteLine( "Displays the elements using GetKey and Get:" );
      PrintKeysAndValues2( myCol );

      // Gets a value either by index or by key.
      Console.WriteLine( "Index 1 contains the value {0}.", myCol[1] );
      Console.WriteLine( "Key \"red\" has the value {0}.", myCol["red"] );
      Console.WriteLine();

      // Copies the values to a string array and displays the string array.
      String[] myStrArr = new String[myCol.Count];
      myCol.CopyTo( myStrArr, 0 );
      Console.WriteLine( "The string array contains:" );
      foreach ( String s in myStrArr )
         Console.WriteLine( "   {0}", s );
      Console.WriteLine();

      // Searches for a key and deletes it.
      myCol.Remove( "green" );
      Console.WriteLine( "The collection contains the following elements after removing \"green\":" );
      PrintKeysAndValues( myCol );

      // Clears the entire collection.
      myCol.Clear();
      Console.WriteLine( "The collection contains the following elements after it is cleared:" );
      PrintKeysAndValues( myCol );

   }

   public static void PrintKeysAndValues( NameValueCollection myCol )  {
      Console.WriteLine( "   KEY        VALUE" );
      foreach ( String s in myCol.AllKeys )
         Console.WriteLine( "   {0,-10} {1}", s, myCol[s] );
      Console.WriteLine();
   }

   public static void PrintKeysAndValues2( NameValueCollection myCol )  {
      Console.WriteLine( "   [INDEX] KEY        VALUE" );
      for ( int i = 0; i < myCol.Count; i++ )
         Console.WriteLine( "   [{0}]     {1,-10} {2}", i, myCol.GetKey(i), myCol.Get(i) );
      Console.WriteLine();
   }


}

/*

This code produces the following output.

Displays the elements using the AllKeys property and the Item (indexer) property:
   KEY        VALUE
   red        rojo,rouge
   green      verde
   blue       azul

Displays the elements using GetKey and Get:
   [INDEX] KEY        VALUE
   [0]     red        rojo,rouge
   [1]     green      verde
   [2]     blue       azul

Index 1 contains the value verde.
Key "red" has the value rojo,rouge.

The string array contains:
   rojo,rouge
   verde
   azul

The collection contains the following elements after removing "green":
   KEY        VALUE
   red        rojo,rouge
   blue       azul

The collection contains the following elements after it is cleared:
   KEY        VALUE


*/
' The following code example demonstrates several of the properties and methods of ListDictionary.

Imports System
Imports System.Collections
Imports System.Collections.Specialized


Public Class SamplesNameValueCollection

    Public Shared Sub Main()

        ' Creates and initializes a new NameValueCollection.
        Dim myCol As New NameValueCollection()
        myCol.Add("red", "rojo")
        myCol.Add("green", "verde")
        myCol.Add("blue", "azul")
        myCol.Add("red", "rouge")

        ' Displays the values in the NameValueCollection in two different ways.
        Console.WriteLine("Displays the elements using the AllKeys property and the Item (indexer) property:")
        PrintKeysAndValues(myCol)
        Console.WriteLine("Displays the elements using GetKey and Get:")
        PrintKeysAndValues2(myCol)

        ' Gets a value either by index or by key.
        Console.WriteLine("Index 1 contains the value {0}.", myCol(1))
        Console.WriteLine("Key ""red"" has the value {0}.", myCol("red"))
        Console.WriteLine()

        ' Copies the values to a string array and displays the string array.
        Dim myStrArr(myCol.Count) As String
        myCol.CopyTo(myStrArr, 0)
        Console.WriteLine("The string array contains:")
        Dim s As String
        For Each s In myStrArr
            Console.WriteLine("   {0}", s)
        Next s
        Console.WriteLine()

        ' Searches for a key and deletes it.
        myCol.Remove("green")
        Console.WriteLine("The collection contains the following elements after removing ""green"":")
        PrintKeysAndValues(myCol)

        ' Clears the entire collection.
        myCol.Clear()
        Console.WriteLine("The collection contains the following elements after it is cleared:")
        PrintKeysAndValues(myCol)

    End Sub 'Main

    Public Shared Sub PrintKeysAndValues(myCol As NameValueCollection)
        Console.WriteLine("   KEY        VALUE")
        Dim s As String
        For Each s In  myCol.AllKeys
            Console.WriteLine("   {0,-10} {1}", s, myCol(s))
        Next s
        Console.WriteLine()
    End Sub 'PrintKeysAndValues

    Public Shared Sub PrintKeysAndValues2(myCol As NameValueCollection)
        Console.WriteLine("   [INDEX] KEY        VALUE")
        Dim i As Integer
        For i = 0 To myCol.Count - 1
            Console.WriteLine("   [{0}]     {1,-10} {2}", i, myCol.GetKey(i), myCol.Get(i))
        Next i
        Console.WriteLine()
    End Sub 'PrintKeysAndValues2

End Class 'SamplesNameValueCollection 


'This code produces the following output.
'
'Displays the elements using the AllKeys property and the Item (indexer) property:
'   KEY        VALUE
'   red        rojo,rouge
'   green      verde
'   blue       azul
'
'Displays the elements using GetKey and Get:
'   [INDEX] KEY        VALUE
'   [0]     red        rojo,rouge
'   [1]     green      verde
'   [2]     blue       azul
'
'Index 1 contains the value verde.
'Key "red" has the value rojo,rouge.
'
'The string array contains:
'   red
'   green
'   blue
'
'
'The collection contains the following elements after removing "green":
'   KEY        VALUE
'   red        rojo,rouge
'   blue       azul
'
'The collection contains the following elements after it is cleared:
'   KEY        VALUE
'
'

Remarques

Cette collection est basée sur la NameObjectCollectionBase classe.This collection is based on the NameObjectCollectionBase class. Chaque élément de la collection est une paire clé/valeur.Each element of the collection is a key/value pair. Cependant, contrairement à la NameObjectCollectionBase, cette classe peut stocker plusieurs valeurs de chaîne sous une clé unique.However, unlike the NameObjectCollectionBase, this class can store multiple string values under a single key.

Cette classe peut être utilisée pour les en-têtes, les chaînes de requête et les données de formulaire.This class can be used for headers, query strings and form data.

Collections de ce type ne conservent pas l’ordre des éléments, et aucun classement particulier n’est garantie lors de l’énumération de la collection.Collections of this type do not preserve the ordering of elements, and no particular ordering is guaranteed when enumerating the collection.

La capacité d’un NameValueCollection est le nombre d’éléments du NameValueCollection peut contenir.The capacity of a NameValueCollection is the number of elements the NameValueCollection can hold. Lorsque des éléments sont ajoutés, sa capacité augmente automatiquement par réallocation.As elements are added, its capacity is automatically increased as required through reallocation.

Le fournisseur de code de hachage fournit les codes de hachage des clés dans le NameValueCollection.The hash code provider dispenses hash codes for keys in the NameValueCollection. Le fournisseur de code de hachage par défaut est le CaseInsensitiveHashCodeProvider.The default hash code provider is the CaseInsensitiveHashCodeProvider.

Le comparateur détermine si deux clés sont égales.The comparer determines whether two keys are equal. Le comparateur par défaut est un CaseInsensitiveComparer qui utilise les conventions de la culture dite indifférente; autrement dit, les comparaisons clés respectent la casse par défaut.The default comparer is a CaseInsensitiveComparer that uses the conventions of the invariant culture; that is, key comparisons are case-insensitive by default. Pour effectuer des comparaisons de clés respectant la casse, appelez le NameValueCollection.NameValueCollection(IEqualityComparer) constructeur et fournir une valeur de StringComparer.CurrentCulture, StringComparer.InvariantCulture, ou StringComparer.Ordinal comme le equalityComparer argument.To perform case-sensitive key comparisons, call the NameValueCollection.NameValueCollection(IEqualityComparer) constructor, and provide a value of StringComparer.CurrentCulture, StringComparer.InvariantCulture, or StringComparer.Ordinal as the equalityComparer argument. Pour plus d’informations sur les effets de culture sur les comparaisons et le tri, consultez Performing Culture-Insensitive String Operations.For more information about how culture affects comparisons and sorting, see Performing Culture-Insensitive String Operations.

null est autorisé en tant que clé ou en tant que valeur.null is allowed as a key or as a value.

Attention

Le Get méthode ne fait pas la distinction entre null qui est retourné parce que la clé spécifiée est introuvable et null qui est retourné parce que la valeur associée à la clé est null.The Get method does not distinguish between null which is returned because the specified key is not found and null which is returned because the value associated with the key is null.

Constructeurs

NameValueCollection() NameValueCollection() NameValueCollection() NameValueCollection()

Initialise une nouvelle instance de la classe NameValueCollection qui est vide, possède la capacité initiale par défaut et utilise le fournisseur de code de hachage ne respectant pas la casse par défaut, ainsi que le comparateur ne respectant pas la casse par défaut.Initializes a new instance of the NameValueCollection class that is empty, has the default initial capacity and uses the default case-insensitive hash code provider and the default case-insensitive comparer.

NameValueCollection(IEqualityComparer) NameValueCollection(IEqualityComparer) NameValueCollection(IEqualityComparer) NameValueCollection(IEqualityComparer)

Initialise une nouvelle instance de la classe NameValueCollection qui est vide, possède la capacité initiale par défaut et utilise l'objet IEqualityComparer spécifié.Initializes a new instance of the NameValueCollection class that is empty, has the default initial capacity, and uses the specified IEqualityComparer object.

NameValueCollection(IHashCodeProvider, IComparer) NameValueCollection(IHashCodeProvider, IComparer) NameValueCollection(IHashCodeProvider, IComparer) NameValueCollection(IHashCodeProvider, IComparer)

Initialise une nouvelle instance de la classe NameValueCollection qui est vide, possède la capacité initiale par défaut et utilise le fournisseur de code de hachage spécifié, ainsi que le comparateur spécifié.Initializes a new instance of the NameValueCollection class that is empty, has the default initial capacity and uses the specified hash code provider and the specified comparer.

NameValueCollection(Int32) NameValueCollection(Int32) NameValueCollection(Int32) NameValueCollection(Int32)

Initialise une nouvelle instance de la classe NameValueCollection qui est vide, possède la capacité initiale spécifiée et utilise le fournisseur de code de hachage ne respectant pas la casse par défaut, ainsi que le comparateur ne respectant pas la casse par défaut.Initializes a new instance of the NameValueCollection class that is empty, has the specified initial capacity and uses the default case-insensitive hash code provider and the default case-insensitive comparer.

NameValueCollection(Int32, IEqualityComparer) NameValueCollection(Int32, IEqualityComparer) NameValueCollection(Int32, IEqualityComparer) NameValueCollection(Int32, IEqualityComparer)

Initialise une nouvelle instance de la classe NameValueCollection qui est vide, possède la capacité initiale spécifiée et utilise l'objet IEqualityComparer spécifié.Initializes a new instance of the NameValueCollection class that is empty, has the specified initial capacity, and uses the specified IEqualityComparer object.

NameValueCollection(Int32, IHashCodeProvider, IComparer) NameValueCollection(Int32, IHashCodeProvider, IComparer) NameValueCollection(Int32, IHashCodeProvider, IComparer) NameValueCollection(Int32, IHashCodeProvider, IComparer)

Initialise une nouvelle instance de la classe NameValueCollection qui est vide, possède la capacité initiale spécifiée et utilise le fournisseur de code de hachage spécifié, ainsi que le comparateur spécifié.Initializes a new instance of the NameValueCollection class that is empty, has the specified initial capacity and uses the specified hash code provider and the specified comparer.

NameValueCollection(Int32, NameValueCollection) NameValueCollection(Int32, NameValueCollection) NameValueCollection(Int32, NameValueCollection) NameValueCollection(Int32, NameValueCollection)

Copie les entrées du NameValueCollection spécifié vers un nouveau NameValueCollection possédant la capacité initiale spécifiée ou la même capacité initiale que le nombre d'entrées copiées (selon la valeur la plus élevée) et utilisant le fournisseur de code de hachage ne respectant pas la casse par défaut, ainsi que le comparateur ne respectant pas la casse par défaut.Copies the entries from the specified NameValueCollection to a new NameValueCollection with the specified initial capacity or the same initial capacity as the number of entries copied, whichever is greater, and using the default case-insensitive hash code provider and the default case-insensitive comparer.

NameValueCollection(NameValueCollection) NameValueCollection(NameValueCollection) NameValueCollection(NameValueCollection) NameValueCollection(NameValueCollection)

Copie les entrées du NameValueCollection spécifié vers un nouveau NameValueCollection possédant la même capacité initiale que le nombre d'entrées copiées et utilisant le même fournisseur de code de hachage, ainsi que le même comparateur que celui de la collection source.Copies the entries from the specified NameValueCollection to a new NameValueCollection with the same initial capacity as the number of entries copied and using the same hash code provider and the same comparer as the source collection.

NameValueCollection(SerializationInfo, StreamingContext) NameValueCollection(SerializationInfo, StreamingContext) NameValueCollection(SerializationInfo, StreamingContext) NameValueCollection(SerializationInfo, StreamingContext)

Initialise une nouvelle instance de la classe NameValueCollection qui est sérialisable et utilise les éléments SerializationInfo et StreamingContext spécifiés.Initializes a new instance of the NameValueCollection class that is serializable and uses the specified SerializationInfo and StreamingContext.

Propriétés

AllKeys AllKeys AllKeys AllKeys

Obtient toutes les clés contenues dans le NameValueCollection.Gets all the keys in the NameValueCollection.

Count Count Count Count

Obtient le nombre de paires clé/valeur contenues dans l'instance du NameObjectCollectionBase.Gets the number of key/value pairs contained in the NameObjectCollectionBase instance.

(Inherited from NameObjectCollectionBase)
ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized

Obtient une valeur indiquant si l’accès à l’objet NameObjectCollectionBase est synchronisé (thread-safe).Gets a value indicating whether access to the NameObjectCollectionBase object is synchronized (thread safe).

(Inherited from NameObjectCollectionBase)
ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot

Obtient un objet qui peut être utilisé pour synchroniser l’accès à l’objet NameObjectCollectionBase.Gets an object that can be used to synchronize access to the NameObjectCollectionBase object.

(Inherited from NameObjectCollectionBase)
IsReadOnly IsReadOnly IsReadOnly IsReadOnly

Obtient ou définit une valeur indiquant si l'instance du NameObjectCollectionBase est en lecture seule.Gets or sets a value indicating whether the NameObjectCollectionBase instance is read-only.

(Inherited from NameObjectCollectionBase)
Item[Int32] Item[Int32] Item[Int32] Item[Int32]

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

Item[String] Item[String] Item[String] Item[String]

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

Keys Keys Keys Keys

Obtient une instance du NameObjectCollectionBase.KeysCollection qui contient toutes les clés dans l'instance du NameObjectCollectionBase.Gets a NameObjectCollectionBase.KeysCollection instance that contains all the keys in the NameObjectCollectionBase instance.

(Inherited from NameObjectCollectionBase)

Méthodes

Add(NameValueCollection) Add(NameValueCollection) Add(NameValueCollection) Add(NameValueCollection)

Copie les entrées dans le NameValueCollection spécifié pour le NameValueCollection en cours.Copies the entries in the specified NameValueCollection to the current NameValueCollection.

Add(String, String) Add(String, String) Add(String, String) Add(String, String)

Ajoute une entrée possédant le nom et la valeur spécifiés au NameValueCollection.Adds an entry with the specified name and value to the NameValueCollection.

BaseAdd(String, Object) BaseAdd(String, Object) BaseAdd(String, Object) BaseAdd(String, Object)

Ajoute une entrée contenant la clé et la valeur spécifiées dans l'instance du NameObjectCollectionBase.Adds an entry with the specified key and value into the NameObjectCollectionBase instance.

(Inherited from NameObjectCollectionBase)
BaseClear() BaseClear() BaseClear() BaseClear()

Supprime toutes les entrées de l'instance du NameObjectCollectionBase.Removes all entries from the NameObjectCollectionBase instance.

(Inherited from NameObjectCollectionBase)
BaseGet(Int32) BaseGet(Int32) BaseGet(Int32) BaseGet(Int32)

Obtient la valeur de l'entrée à l'index spécifié de l'instance du NameObjectCollectionBase.Gets the value of the entry at the specified index of the NameObjectCollectionBase instance.

(Inherited from NameObjectCollectionBase)
BaseGet(String) BaseGet(String) BaseGet(String) BaseGet(String)

Obtient la valeur de la première entrée ayant la clé spécifiée dans l'instance du NameObjectCollectionBase.Gets the value of the first entry with the specified key from the NameObjectCollectionBase instance.

(Inherited from NameObjectCollectionBase)
BaseGetAllKeys() BaseGetAllKeys() BaseGetAllKeys() BaseGetAllKeys()

Retourne un tableau de type String qui contient toutes les clés dans l'instance du NameObjectCollectionBase.Returns a String array that contains all the keys in the NameObjectCollectionBase instance.

(Inherited from NameObjectCollectionBase)
BaseGetAllValues() BaseGetAllValues() BaseGetAllValues() BaseGetAllValues()

Retourne un tableau d'éléments Object qui contient toutes les valeurs présentes dans l'instance du NameObjectCollectionBase.Returns an Object array that contains all the values in the NameObjectCollectionBase instance.

(Inherited from NameObjectCollectionBase)
BaseGetAllValues(Type) BaseGetAllValues(Type) BaseGetAllValues(Type) BaseGetAllValues(Type)

Retourne un tableau du type spécifié qui contient toutes les valeurs présentes dans l'instance du NameObjectCollectionBase.Returns an array of the specified type that contains all the values in the NameObjectCollectionBase instance.

(Inherited from NameObjectCollectionBase)
BaseGetKey(Int32) BaseGetKey(Int32) BaseGetKey(Int32) BaseGetKey(Int32)

Obtient la clé de l'entrée à l'index spécifié de l'instance du NameObjectCollectionBase.Gets the key of the entry at the specified index of the NameObjectCollectionBase instance.

(Inherited from NameObjectCollectionBase)
BaseHasKeys() BaseHasKeys() BaseHasKeys() BaseHasKeys()

Obtient une valeur indiquant si l'instance du NameObjectCollectionBase contient des entrées dont les clés ne sont pas null.Gets a value indicating whether the NameObjectCollectionBase instance contains entries whose keys are not null.

(Inherited from NameObjectCollectionBase)
BaseRemove(String) BaseRemove(String) BaseRemove(String) BaseRemove(String)

Supprime les entrées contenant la clé spécifiée dans l'instance du NameObjectCollectionBase.Removes the entries with the specified key from the NameObjectCollectionBase instance.

(Inherited from NameObjectCollectionBase)
BaseRemoveAt(Int32) BaseRemoveAt(Int32) BaseRemoveAt(Int32) BaseRemoveAt(Int32)

Supprime les entrées à l'index spécifié de l'instance du NameObjectCollectionBase.Removes the entry at the specified index of the NameObjectCollectionBase instance.

(Inherited from NameObjectCollectionBase)
BaseSet(Int32, Object) BaseSet(Int32, Object) BaseSet(Int32, Object) BaseSet(Int32, Object)

Définit la valeur de l'entrée à l'index spécifié de l'instance du NameObjectCollectionBase.Sets the value of the entry at the specified index of the NameObjectCollectionBase instance.

(Inherited from NameObjectCollectionBase)
BaseSet(String, Object) BaseSet(String, Object) BaseSet(String, Object) BaseSet(String, Object)

Définit la valeur de la première entrée contenant la clé spécifiée dans l'instance du NameObjectCollectionBase, si elle existe ; sinon, ajoute une entrée contenant la clé et la valeur spécifiées dans l'instance du NameObjectCollectionBase.Sets the value of the first entry with the specified key in the NameObjectCollectionBase instance, if found; otherwise, adds an entry with the specified key and value into the NameObjectCollectionBase instance.

(Inherited from NameObjectCollectionBase)
Clear() Clear() Clear() Clear()

Invalide les tableaux mis en cache et supprime toutes les entrées du NameValueCollection.Invalidates the cached arrays and removes all entries from the NameValueCollection.

CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32)

Copie l'ensemble de l'objet NameValueCollection vers un objet Array unidimensionnel compatible, en commençant à l'index spécifié du tableau cible.Copies the entire NameValueCollection to a compatible one-dimensional Array, starting at the specified index of the target array.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Get(Int32) Get(Int32) Get(Int32) Get(Int32)

Obtient les valeurs à l'index spécifié de NameValueCollection, combinées dans une même liste avec la virgule comme séparateur.Gets the values at the specified index of the NameValueCollection combined into one comma-separated list.

Get(String) Get(String) Get(String) Get(String)

Obtient les valeurs associées à la clé spécifiée de NameValueCollection, combinées dans une même liste avec la virgule comme séparateur.Gets the values associated with the specified key from the NameValueCollection combined into one comma-separated list.

GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Retourne un énumérateur qui itère au sein de NameObjectCollectionBase.Returns an enumerator that iterates through the NameObjectCollectionBase.

(Inherited from NameObjectCollectionBase)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetKey(Int32) GetKey(Int32) GetKey(Int32) GetKey(Int32)

Obtient la clé à l'index spécifié de NameValueCollection.Gets the key at the specified index of the NameValueCollection.

GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext)

Implémente l'interface ISerializable et retourne les données nécessaires pour sérialiser l'instance NameObjectCollectionBase.Implements the ISerializable interface and returns the data needed to serialize the NameObjectCollectionBase instance.

(Inherited from NameObjectCollectionBase)
GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
GetValues(Int32) GetValues(Int32) GetValues(Int32) GetValues(Int32)

Obtient les valeurs à l'index spécifié de NameValueCollection.Gets the values at the specified index of the NameValueCollection.

GetValues(String) GetValues(String) GetValues(String) GetValues(String)

Obtient les valeurs associées à la clé spécifiée à partir de NameValueCollection.Gets the values associated with the specified key from the NameValueCollection.

HasKeys() HasKeys() HasKeys() HasKeys()

Obtient une valeur qui indique si NameValueCollection contient des clés qui ne sont pas null.Gets a value indicating whether the NameValueCollection contains keys that are not null.

InvalidateCachedArrays() InvalidateCachedArrays() InvalidateCachedArrays() InvalidateCachedArrays()

Réaffecte la valeur null aux tableaux mis en cache de la collection.Resets the cached arrays of the collection to null.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
OnDeserialization(Object) OnDeserialization(Object) OnDeserialization(Object) OnDeserialization(Object)

Implémente l’interface ISerializable et déclenche l’événement de désérialisation une fois la désérialisation terminée.Implements the ISerializable interface and raises the deserialization event when the deserialization is complete.

(Inherited from NameObjectCollectionBase)
Remove(String) Remove(String) Remove(String) Remove(String)

Supprime les entrées contenant la clé spécifiée dans l'instance du NameObjectCollectionBase.Removes the entries with the specified key from the NameObjectCollectionBase instance.

Set(String, String) Set(String, String) Set(String, String) Set(String, String)

Définit la valeur d'une entrée dans NameValueCollection.Sets the value of an entry in the NameValueCollection.

ToString() ToString() ToString() ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)

Implémentations d’interfaces explicites

ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32)

Copie l'ensemble de l'objet NameObjectCollectionBase vers un objet Array unidimensionnel compatible, en commençant à l'index spécifié du tableau cible.Copies the entire NameObjectCollectionBase to a compatible one-dimensional Array, starting at the specified index of the target array.

(Inherited from NameObjectCollectionBase)

Méthodes d’extension

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Effectue un cast des éléments d'un IEnumerable vers le type spécifié.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Filtre les éléments d'un IEnumerable en fonction du type spécifié.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Active la parallélisation d'une requête.Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Convertit un IEnumerable à un IQueryable.Converts an IEnumerable to an IQueryable.

S’applique à

Cohérence de thread

Statique public (Shared en Visual Basic) de ce type sont thread-safe.Public static (Shared in Visual Basic) members of this type are thread safe. Il n'est pas garanti que les membres d'instance soient thread-safe.Any instance members are not guaranteed to be thread safe.

Cette implémentation ne fournit pas synchronisé wrapper (thread-safe) pour un NameValueCollection, mais les classes dérivées peuvent créer leurs propres versions synchronisées de la NameValueCollection à l’aide de la SyncRoot propriété de la NameObjectCollectionBase classe.This implementation does not provide a synchronized (thread safe) wrapper for a NameValueCollection, but derived classes can create their own synchronized versions of the NameValueCollection using the SyncRoot property of the NameObjectCollectionBase class.

L’énumération d’une collection n’est pas intrinsèquement une procédure thread-safe.Enumerating through a collection is intrinsically not a thread safe procedure. Même lorsqu'une collection est synchronisée, les autres threads peuvent toujours la modifier, ce qui entraîne la levée d'une exception par l'énumérateur.Even when a collection is synchronized, other threads can still modify the collection, which causes the enumerator to throw an exception. Pour garantir la sécurité des threads au cours de l’énumération, vous pouvez verrouiller la collection pendant l’ensemble de l’énumération ou bien intercepter les exceptions résultant des modifications apportées par les autres threads.To guarantee thread safety during enumeration, you can either lock the collection during the entire enumeration or catch the exceptions resulting from changes made by other threads.

Voir aussi