OrderedDictionary.Insert(Int32, Object, Object) Metodo

Definizione

Spazio dei nomi:

System.Collections.Specialized

Assembly:

System.Collections.Specialized.dll

Source:

OrderedDictionary.cs

Inserisce nella raccolta OrderedDictionary una nuova voce contenente la chiave e il valore indicati in corrispondenza dell'indice specificato.

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)

Parametri

index

Int32

Indice in base zero in corrispondenza del quale deve essere inserito l'elemento.

key

Object

Chiave della voce da aggiungere.

value

Object

Valore della voce da aggiungere. Il valore può essere null.

Implementazioni

Insert(Int32, Object, Object)

Eccezioni

ArgumentOutOfRangeException

index non è compreso nell'intervallo consentito.

NotSupportedException

La raccolta è di sola lettura.

Esempio

Nell'esempio di codice seguente viene illustrata la modifica di una OrderedDictionary raccolta. In questo esempio, il Insert metodo viene usato per aggiungere una nuova voce all'inizio di OrderedDictionary, spostando il resto delle voci verso il basso. Questo codice fa parte di un esempio di codice più ampio che può essere visualizzato in 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

Commenti

Se il index parametro è uguale al numero di voci nell'insieme OrderedDictionary , i key parametri e value vengono aggiunti alla fine della raccolta.

Le voci che seguono il punto di inserimento si spostano verso il basso per contenere la nuova voce e vengono aggiornati anche gli indici delle voci spostate.