El método OrderedDictionary.Insert(Int32, Object, Object) se usa para insertar una nueva entrada en la colección OrderedDictionary con la clave y el valor especificados en el índice especificado.
Sintaxis:
public void Insert (int index, object key, object value);
Parámetros:
index : Es el índice de base cero en el que se debe insertar el elemento.
key : Es la clave de la entrada a agregar.
value : Es el valor de la entrada a sumar. El valor puede ser nulo.
Excepciones:
- NotSupportedException: si la colección OrderedDictionary es de solo lectura.
- ArgumentOutOfRangeException: si el índice está fuera de rango.
A continuación se dan algunos ejemplos para entender la implementación de una mejor manera:
Ejemplo 1:
// C# code to insert entry into // OrderedDictionary with key and // value at the specified index using System; using System.Collections; using System.Collections.Specialized; class GFG { // Driver method public static void Main() { // Creating a orderedDictionary named myDict OrderedDictionary myDict = new OrderedDictionary(); // Adding key and value in myDict myDict.Add("key1", "value1"); myDict.Add("key2", "value2"); myDict.Add("key3", "value3"); myDict.Add("key4", "value4"); myDict.Add("key5", "value5"); // Displaying the number of element initially Console.WriteLine("Number of elements are : " + myDict.Count); // Displaying the elements in myDict foreach(DictionaryEntry de in myDict) Console.WriteLine(de.Key + " -- " + de.Value); // Inserting entry into OrderedDictionary // with key and value at the specified index myDict.Insert(2, "Geeks", "Noida"); // Displaying the number of element initially Console.WriteLine("Number of elements are : " + myDict.Count); // Displaying the elements in myDict foreach(DictionaryEntry de in myDict) Console.WriteLine(de.Key + " -- " + de.Value); } }
Producción:
Number of elements are : 5 key1 -- value1 key2 -- value2 key3 -- value3 key4 -- value4 key5 -- value5 Number of elements are : 6 key1 -- value1 key2 -- value2 Geeks -- Noida key3 -- value3 key4 -- value4 key5 -- value5
Ejemplo 2:
// C# code to insert entry into // OrderedDictionary with key and // value at the specified index using System; using System.Collections; using System.Collections.Specialized; class GFG { // Driver method public static void Main() { // Creating a orderedDictionary named myDict OrderedDictionary myDict = new OrderedDictionary(); // Adding key and value in myDict myDict.Add("A", "Apple"); myDict.Add("B", "Banana"); myDict.Add("C", "Cat"); myDict.Add("D", "Dog"); // Displaying the number of element initially Console.WriteLine("Number of elements are : " + myDict.Count); // Displaying the elements in myDict foreach(DictionaryEntry de in myDict) Console.WriteLine(de.Key + " -- " + de.Value); // Inserting entry into OrderedDictionary // with key and value at the specified index // This should raise "ArgumentOutOfRangeException" // as index is out of range myDict.Insert(10, "E", "Elephant"); // Displaying the number of element initially Console.WriteLine("Number of elements are : " + myDict.Count); // Displaying the elements in myDict foreach(DictionaryEntry de in myDict) Console.WriteLine(de.Key + " -- " + de.Value); } }
Error de tiempo de ejecución:
Excepción no controlada:
System.ArgumentOutOfRangeException: el argumento especificado estaba fuera del rango de valores válidos.
Nombre del parámetro: índice
Nota:
- Si el parámetro de índice es igual al número de entradas en la colección OrderedDictionary, los parámetros de clave y valor se agregan al final de la colección.
- Las entradas que siguen al punto de inserción se mueven hacia abajo para acomodar la nueva entrada y los índices de las entradas movidas también se actualizan.
Referencia:
Publicación traducida automáticamente
Artículo escrito por Sahil_Bansall y traducido por Barcelona Geeks. The original can be accessed here. Licence: CCBY-SA