OrderedDictionary.Insert(Int32, Object, Object) Método

Definición

Espacio de nombres:

System.Collections.Specialized

Ensamblado:

System.Collections.Specialized.dll

Source:

OrderedDictionary.cs

Inserta una nueva entrada en la colección OrderedDictionary con la clave y el valor especificados en el índice especificado.

public:
 virtual void Insert(int index, System::Object ^ key, System::Object ^ value);

public void Insert (int index, object key, object? value);

abstract member Insert : int * obj * obj -> unit
override this.Insert : int * obj * obj -> unit

Public Sub Insert (index As Integer, key As Object, value As Object)

Parámetros

index

Int32

Índice de base cero en el que se debe insertar el elemento.

key

Object

Clave de la entrada que se va a agregar.

value

Object

Valor de la entrada que se va a agregar. El valor puede ser null.

Implementaciones

Insert(Int32, Object, Object)

Excepciones

ArgumentOutOfRangeException

index está fuera del intervalo.

NotSupportedException

Esta colección es de solo lectura.

Ejemplos

En el ejemplo de código siguiente se muestra la modificación de una OrderedDictionary colección. En este ejemplo, el Insert método se usa para agregar una nueva entrada al principio de OrderedDictionary, moviendo el resto de las entradas hacia abajo. Este código forma parte de un ejemplo de código más grande que se puede ver en OrderedDictionary.

// Modifying the OrderedDictionary
if (!myOrderedDictionary->IsReadOnly)
{
    // Insert a new key to the beginning of the OrderedDictionary
    myOrderedDictionary->Insert(0, "insertedKey1", "insertedValue1");

    // Modify the value of the entry with the key "testKey2"
    myOrderedDictionary["testKey2"] = "modifiedValue";

    // Remove the last entry from the OrderedDictionary: "testKey3"
    myOrderedDictionary->RemoveAt(myOrderedDictionary->Count - 1);

    // Remove the "keyToDelete" entry, if it exists
    if (myOrderedDictionary->Contains("keyToDelete"))
    {
        myOrderedDictionary->Remove("keyToDelete");
    }
}

// Modifying the OrderedDictionary
if (!myOrderedDictionary.IsReadOnly)
{
    // Insert a new key to the beginning of the OrderedDictionary
    myOrderedDictionary.Insert(0, "insertedKey1", "insertedValue1");

    // Modify the value of the entry with the key "testKey2"
    myOrderedDictionary["testKey2"] = "modifiedValue";

    // Remove the last entry from the OrderedDictionary: "testKey3"
    myOrderedDictionary.RemoveAt(myOrderedDictionary.Count - 1);

    // Remove the "keyToDelete" entry, if it exists
    if (myOrderedDictionary.Contains("keyToDelete"))
    {
        myOrderedDictionary.Remove("keyToDelete");
    }
}

' Modifying the OrderedDictionary
If Not myOrderedDictionary.IsReadOnly Then

    ' Insert a new key to the beginning of the OrderedDictionary
    myOrderedDictionary.Insert(0, "insertedKey1", "insertedValue1")

    ' Modify the value of the entry with the key "testKey2"
    myOrderedDictionary("testKey2") = "modifiedValue"

    ' Remove the last entry from the OrderedDictionary: "testKey3"
    myOrderedDictionary.RemoveAt(myOrderedDictionary.Count - 1)

    ' Remove the "keyToDelete" entry, if it exists
    If (myOrderedDictionary.Contains("keyToDelete")) Then
        myOrderedDictionary.Remove("keyToDelete")
    End If
End If

Comentarios

Si el index parámetro es igual al número de entradas de la OrderedDictionary colección, los key parámetros y value se anexan al final de la colección.

Las entradas que siguen al punto de inserción se mueven hacia abajo para dar cabida a la nueva entrada y también se actualizan los índices de las entradas movidas.