OrderedDictionary.Item[] Свойство

Определение

Пространство имен:

System.Collections.Specialized

Сборка:

System.Collections.Specialized.dll

Возвращает или задает указанное значение.

Перегрузки

Item[Int32]	Возвращает или задает значение по указанному индексу.
Item[Object]	Возвращает или задает значение с указанным ключом.

Item[Int32]

Исходный код:

OrderedDictionary.cs

Возвращает или задает значение по указанному индексу.

public:
 property System::Object ^ default[int] { System::Object ^ get(int index); void set(int index, System::Object ^ value); };

public object? this[int index] { get; set; }

member this.Item(int) : obj with get, set

Default Public Property Item(index As Integer) As Object

Параметры

index

Int32

Отсчитываемый от нуля индекс возвращаемого или задаваемого значения.

Значение свойства

Object

Значение элемента с заданным индексом.

Реализации

Item[Int32]

Исключения

NotSupportedException

Свойство задается, и коллекция OrderedDictionary доступна только для чтения.

ArgumentOutOfRangeException

Значение параметра index меньше нуля.

-или-

Значение параметра index больше или равно значению свойства Count.

Комментарии

Это свойство позволяет получить доступ к определенному элементу в коллекции с помощью следующего синтаксиса: myCollection[index].

Язык C# использует этот ключевое слово для определения индексаторов вместо реализации Item[] свойства . Visual Basic реализует Item[] в качестве свойства по умолчанию, которое предоставляет те же функции индексирования.

Item[Object]

Исходный код:

OrderedDictionary.cs

Возвращает или задает значение с указанным ключом.

public:
 property System::Object ^ default[System::Object ^] { System::Object ^ get(System::Object ^ key); void set(System::Object ^ key, System::Object ^ value); };

public object? this[object key] { get; set; }

member this.Item(obj) : obj with get, set

Default Public Property Item(key As Object) As Object

Параметры

key

Object

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

Значение свойства

Object

Значение, связанное с указанным ключом. Если указанный ключ не найден, при попытке его получения возвращается значение null, а при попытке задания ключа создается новый элемент с использованием указанного ключа.

Реализации

Item[Object]

Исключения

NotSupportedException

Свойство задается, и коллекция OrderedDictionary доступна только для чтения.

Примеры

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

Комментарии

Это свойство позволяет получить доступ к определенному элементу в коллекции с помощью следующего синтаксиса: myCollection[key].

Свойство также можно использовать Item[] для добавления новых элементов, задав значение ключа, не существующего OrderedDictionary в коллекции (например, myCollection["myNonexistentKey"] = myValue). Однако если указанный ключ уже существует в OrderedDictionary, установка Item[] свойства перезаписывает старое значение. В отличие от этого, Add метод не изменяет существующие элементы.

Ключ не может иметь значение null, но значение может иметь значение . Чтобы различать null возвращаемый ключ, так как указанный ключ не найден, и null , который возвращается из-за того, что значение указанного ключа равно null, используйте Contains метод , чтобы определить, существует ли ключ в OrderedDictionary.