OrderedDictionary.Insert(Int32, Object, Object) Метод

Ссылка

Определение

Пространство имен:: System.Collections.Specialized

Сборки:: System.dll, System.Collections.Specialized.dll

Сборка:: System.Collections.Specialized.dll

Сборка:: System.dll

Сборка:: netstandard.dll

Исходный код:: OrderedDictionary.cs

Исходный код:: OrderedDictionary.cs

Исходный код:: OrderedDictionary.cs

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Вставляет новую запись в коллекцию OrderedDictionary с указанным ключом и значением по указанному индексу.

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)

Параметры

index: Int32

Отсчитываемый от нуля индекс, по которому следует вставить элемент.

key: Object

Ключ записи, которую требуется добавить.

value: Object

Добавляемое значение записи. Допускается значение null.

Реализации

Insert(Int32, Object, Object)

Исключения

ArgumentOutOfRangeException

index выходит за пределы диапазона.

NotSupportedException

Эта коллекция доступна только для чтения.

Примеры

В следующем примере кода демонстрируется изменение OrderedDictionary коллекции. В этом примере Insert метод используется для добавления новой записи в начало OrderedDictionary, перемещения остальных записей вниз. Этот код является частью более крупного примера кода, который можно просмотреть по адресу 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

Применяется к

Поделиться через