OrderedDictionary.Insert(Int32, Object, Object) El método 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:
índice: Es el índice de base cero de tipo System.Int32 en el que se debe insertar el elemento.
clave: Es la clave de la entrada a agregar.
value: Es el valor de la entrada a sumar. El valor puede ser nulo .
Excepciones:
- ArgumentOutOfRangeException: si el índice está fuera de rango.
- NotSupportedException: si la colección es de solo lectura.
Los siguientes programas ilustran el uso del método mencionado anteriormente:
Ejemplo 1:
// C# code to add a new entry into the
// OrderedDictionary collection with
// the specified 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");
Console.WriteLine("Before Updation: ");
// Displaying the key/value pairs in myDict
foreach(DictionaryEntry de in myDict)
Console.WriteLine(de.Key + " --> " + de.Value);
// using Insert(Int32, Object, Object) Method
// to add a new entry at index 5
myDict.Insert(5, "key6", "value6");
Console.WriteLine("\nAfter Updation: ");
// Displaying the key/value pairs in myDict
foreach(DictionaryEntry de in myDict)
Console.WriteLine(de.Key + " --> " + de.Value);
}
}
Producción:
Before Updation: key1 --> value1 key2 --> value2 key3 --> value3 key4 --> value4 key5 --> value5 After Updation: key1 --> value1 key2 --> value2 key3 --> value3 key4 --> value4 key5 --> value5 key6 --> value6
Ejemplo 2:
// C# code to add a new entry into the
// OrderedDictionary collection with
// the specified 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("1", "C");
myDict.Add("2", "C++");
myDict.Add("3", "Java");
myDict.Add("4", "Python");
myDict.Add("5", "C#");
Console.WriteLine("Before Updation: ");
// Displaying the key/value pairs in myDict
foreach(DictionaryEntry de in myDict)
Console.WriteLine(de.Key + " --> " + de.Value);
// using Insert(Int32, Object, Object) Method
// this will give error as index is out of range
// here indexing is zero-based
myDict.Insert(6, "6", "HTML");
Console.WriteLine("\nAfter Updation: ");
// Displaying the key/value pairs 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:
- Los parámetros de clave y valor se agregarán al final de la colección si el parámetro de índice es igual al número de entradas en la colección OrderedDictionary.
- 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 Kirti_Mangal y traducido por Barcelona Geeks. The original can be accessed here. Licence: CCBY-SA