IMap<K,V> Интерфейс

Определение

public interface class IMap : IIterable<IKeyValuePair<K, V> ^>

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.FoundationContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(1009329662, 34073, 17857, 170, 121, 25, 123, 103, 24, 193, 193)]
template <typename K, typename V>
struct IMap : IIterable<IKeyValuePair<K, V>>

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.FoundationContract), 65536)]
[Windows.Foundation.Metadata.Guid(1009329662, 34073, 17857, 170, 121, 25, 123, 103, 24, 193, 193)]
public interface IDictionary<K,V> : IEnumerable<KeyValuePair<K,V>>

Public Interface IDictionary(Of K, V)
Implements IEnumerable(Of KeyValuePair(Of K, V))

Параметры типа

Атрибуты

ContractVersionAttribute GuidAttribute

Реализации

IIterable<IKeyValuePair<K,V>> IEnumerable<KeyValuePair<K,V>>

Требования к Windows

Комментарии

При программировании с помощью .NET этот интерфейс скрыт, и разработчики должны использовать интерфейс System.Collections.Generic.IDictionary<TKey,TValue> , если они хотят реализовать тип карты или словаря. В любом случае, когда тип среда выполнения Windows реализует IMap<K,V>, код .NET может использовать API IDictionary<TKey,TValue>. Сюда входят все существующие API среда выполнения Windows, а также такие сценарии, как использование API среда выполнения Windows компонентов, изначально реализованных в расширениях компонентов Visual C++ (C++/CX) из приложения C# или Visual Basic.

Интерфейс IMap<K,V> представляет коллекцию пар "ключ-значение", в которых к значению можно получить доступ по связанному ключу. Свойства и методы IMap<K,V> поддерживают функции словарного типа, такие как получение размера коллекции, а также добавление и удаление элементов в указанных расположениях коллекции. Кроме того, метод GetView предоставляет snapshot карты, наблюдаемое состояние которой не изменяется. Этот snapshot полезен, если требуется представление коллекции для ссылки на последующие операции с использованием IMap<K,V>.

Функции расширения C++/WinRT

auto begin() const;

Возвращает итератор первой паре "ключ-значение" коллекции для использования в алгоритмах C++, таких как циклы на основе for диапазона.

auto end() const;

Возвращает итератор после последней пары "ключ-значение" коллекции для использования в алгоритмах C++, таких как циклы на основе for диапазона.

auto TryLookup(param_type<K> const& key) const;

Пытается найти элемент на карте с помощью ключа. Для ссылочных типов возвращает значение , если найдено или nullptr если не найдено. Для типов значений возвращает std::optional<V>, который содержит значение , если он найден, или не имеет значения, если не найден.

bool TryRemove(param_type<K> const& key) const;

Удаляет элемент карты с ключом, если он есть. Возвращает значение true , если элемент был найден и удален. Возвращает значение false , если элемент не найден.

Наследование интерфейса

IMap<K,V> наследует IIterable, используя ограничение IKeyValuePair , которое использует одни и те же типы ключей и значений. Типы, реализующие IMap<K,V> , также реализуют члены интерфейса IIterable, при этом ограничение типа IKeyValuePair использует один и тот же ключ и значение. Аналогичным образом, если вы используете .NET, существует поддержка IEnumerabe<T> с типом ограничения в качестве KeyValuePair , который использует те же типы ключей и значений, что и реализация IDictionary<TKey,TValue> .

Свойства

Методы

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

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

• Коллекции (C++/CX)
• System.Collections.Generic.IDictionary< TKey,TValue>