Прочитать на английском

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


DictionaryEntry Структура

Определение

Определяет пару «ключ-значение», которую можно задать или извлечь.

public struct DictionaryEntry
[System.Serializable]
public struct DictionaryEntry
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public struct DictionaryEntry
Наследование
DictionaryEntry
Атрибуты

Примеры

В следующем примере показано использование DictionaryEntry для итерации по объекту Hashtable .

// A simple example for the DictionaryEntry structure.
using System;
using System.Collections;

class Example
{
    public static void Main()
    {
        // Create a new hash table.
        //
        Hashtable openWith = new Hashtable();

        // Add some elements to the hash table. There are no
        // duplicate keys, but some of the values are duplicates.
        openWith.Add("txt", "notepad.exe");
        openWith.Add("bmp", "paint.exe");
        openWith.Add("dib", "paint.exe");
        openWith.Add("rtf", "wordpad.exe");

        // When you use foreach to enumerate hash table elements,
        // the elements are retrieved as DictionaryEntry objects.
        Console.WriteLine();
        foreach (DictionaryEntry de in openWith)
        {
            Console.WriteLine("Key = {0}, Value = {1}", de.Key, de.Value);
        }
    }
}

/* This code example produces output similar to the following:

Key = rtf, Value = wordpad.exe
Key = txt, Value = notepad.exe
Key = dib, Value = paint.exe
Key = bmp, Value = paint.exe
 */

Комментарии

Метод IDictionaryEnumerator.Entry возвращает экземпляр этого типа.

Важно!

Не рекомендуется использовать структуру для разработки DictionaryEntry новых приложений. Вместо этого рекомендуется использовать универсальную KeyValuePair<TKey,TValue> структуру вместе с классом Dictionary<TKey,TValue> . Дополнительные сведения см. в статье Неуниверсовые коллекции не должны использоваться на GitHub.

Операторы C# foreach и Visual Basic For Each требуют тип каждого элемента в коллекции. Так как каждый элемент IDictionary является парой "ключ-значение", тип элемента не является типом ключа или типом значения. Вместо этого используется DictionaryEntryтип элемента . Пример:

foreach (DictionaryEntry de in openWith)
{
    Console.WriteLine("Key = {0}, Value = {1}", de.Key, de.Value);
}

Оператор foreach представляет собой оболочку для перечислителя, которая разрешает чтение только из коллекции, а не из коллекции.

Конструкторы

DictionaryEntry(Object, Object)

Инициализирует экземпляр типа DictionaryEntry с указанным ключом и значением.

Свойства

Key

Получает или задает ключ в паре ключ/значение.

Value

Получает или задает значение в паре ключ/значение.

Методы

Deconstruct(Object, Object)

Деконструирует текущий объект DictionaryEntry.

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

Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

См. также раздел