NameObjectCollectionBase.BaseSet Méthode

Définition

Espace de noms:

System.Collections.Specialized

Assembly:

System.Collections.Specialized.dll

Définit la valeur d'une entrée dans l'instance du NameObjectCollectionBase.

Surcharges

BaseSet(Int32, Object)	Définit la valeur de l'entrée à l'index spécifié de l'instance du NameObjectCollectionBase.
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.

Exemples

L’exemple de code suivant utilise BaseSet pour définir la valeur d’un élément spécifique.

C#

using System;
using System.Collections;
using System.Collections.Specialized;

public class MyCollection : NameObjectCollectionBase  {

   // Gets or sets the value at the specified index.
   public Object this[ int index ]  {
      get  {
         return( this.BaseGet( index ) );
      }
      set  {
         this.BaseSet( index, value );
      }
   }

   // Gets or sets the value associated with the specified key.
   public Object this[ String key ]  {
      get  {
         return( this.BaseGet( key ) );
      }
      set  {
         this.BaseSet( key, value );
      }
   }

   // Gets a String array that contains all the keys in the collection.
   public String[] AllKeys  {
      get  {
         return( this.BaseGetAllKeys() );
      }
   }

   // Adds elements from an IDictionary into the new collection.
   public MyCollection( IDictionary d )  {
      foreach ( DictionaryEntry de in d )  {
         this.BaseAdd( (String) de.Key, de.Value );
      }
   }
}

public class SamplesNameObjectCollectionBase  {

   public static void Main()  {

      // Creates and initializes a new MyCollection instance.
      IDictionary d = new ListDictionary();
      d.Add( "red", "apple" );
      d.Add( "yellow", "banana" );
      d.Add( "green", "pear" );
      MyCollection myCol = new MyCollection( d );
      Console.WriteLine( "Initial state of the collection:" );
      PrintKeysAndValues2( myCol );
      Console.WriteLine();

      // Sets the value at index 1.
      myCol[1] = "sunflower";
      Console.WriteLine( "After setting the value at index 1:" );
      PrintKeysAndValues2( myCol );
      Console.WriteLine();

      // Sets the value associated with the key "red".
      myCol["red"] = "tulip";
      Console.WriteLine( "After setting the value associated with the key \"red\":" );
      PrintKeysAndValues2( myCol );
   }

   public static void PrintKeysAndValues2( MyCollection myCol )  {
      foreach ( String s in myCol.AllKeys )  {
         Console.WriteLine( "{0}, {1}", s, myCol[s] );
      }
   }
}


/*
This code produces the following output.

Initial state of the collection:
red, apple
yellow, banana
green, pear

After setting the value at index 1:
red, apple
yellow, sunflower
green, pear

After setting the value associated with the key "red":
red, tulip
yellow, sunflower
green, pear

*/

BaseSet(Int32, Object)

Source:

NameObjectCollectionBase.cs

Définit la valeur de l'entrée à l'index spécifié de l'instance du NameObjectCollectionBase.

C#

protected void BaseSet (int index, object? value);

Paramètres

index

Int32

Index de base zéro de l'entrée à définir.

value

Object

Object qui représente la nouvelle valeur de l'entrée à définir. La valeur peut être null.

Exceptions

NotSupportedException

La collection est en lecture seule.

ArgumentOutOfRangeException

index est en dehors de la plage valide des index pour la collection.

Remarques

Cette méthode est une opération O(1).

Voir aussi

• Exécution d'opérations de chaînes indépendantes de la culture

BaseSet(String, Object)

Source:

NameObjectCollectionBase.cs

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.

C#

protected void BaseSet (string? name, object? value);

Paramètres

name

String

Clé String de l'entrée à définir. La clé peut être null.

value

Object

Object qui représente la nouvelle valeur de l'entrée à définir. La valeur peut être null.

Exceptions

NotSupportedException

La collection est en lecture seule.

Remarques

Si la collection contient plusieurs entrées avec la clé spécifiée, cette méthode définit uniquement la première entrée. Pour définir les valeurs des entrées suivantes avec la même clé, utilisez l’énumérateur pour itérer au sein de la collection et comparer les clés.

Cette méthode est une opération O(1).

Voir aussi

• GetEnumerator()
• Exécution d'opérations de chaînes indépendantes de la culture