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

Referencia

Definición

Espacio de nombres:: System.Collections.Specialized

Ensamblados:: System.dll, System.Collections.Specialized.dll

Ensamblado:: System.Collections.Specialized.dll

Ensamblado:: System.dll

Ensamblado:: netstandard.dll

Source:: OrderedDictionary.cs

Source:: OrderedDictionary.cs

Source:: OrderedDictionary.cs

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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);

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.

Se aplica a

Compartir vía