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

Определение

Пространство имен:
System.Collections.Specialized
Сборки:
System.dll, System.Collections.Specialized.dll
Сборки:
netstandard.dll, System.Collections.Specialized.dll
Сборка:
System.Collections.Specialized.dll
Сборка:
System.dll
Сборка:
netstandard.dll

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

Перегрузки

Имя Описание
Item[Int32]

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

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

Item[Int32]

Исходный код:
OrderedDictionary.cs
Исходный код:
OrderedDictionary.cs
Исходный код:
OrderedDictionary.cs
Исходный код:
OrderedDictionary.cs
Исходный код:
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; }
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[] как свойство default, которое предоставляет те же функции индексирования.

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

Item[Object]

Исходный код:
OrderedDictionary.cs
Исходный код:
OrderedDictionary.cs
Исходный код:
OrderedDictionary.cs
Исходный код:
OrderedDictionary.cs
Исходный код:
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; }
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 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.

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