Platform::Collections::Map, klasa

Reprezentuje mapę, która jest kolekcją par klucz-wartość. Implementuje element Windows::Foundation::Collections::IObservableMap, aby ułatwić powiązanie danych XAML.

Składnia

template <
   typename K,
   typename V,
   typename C = std::less<K>>
ref class Map sealed;

Parametry

K
Typ klucza w parze klucz-wartość.

V
Typ wartości w parze klucz-wartość.

C
Typ, który udostępnia obiekt funkcji, który może porównać dwie wartości elementów jako klucze sortowania, aby określić ich względną kolejność w mapie. Domyślnie std::less<K>.

__is_valid_winrt_type() Funkcja wygenerowana przez kompilator, która weryfikuje typ K i V i udostępnia przyjazny komunikat o błędzie, jeśli typ nie może być przechowywany w mapie.

Uwagi

Dozwolone typy to:

• liczby całkowite

• interface, klasa^

• public ref class^

• value, struktura

• public enum, klasa

Mapa jest w zasadzie otoką dla std::map. Jest to konkretna implementacja języka C++ typów Windows::Foundation::Collections::IMap<Windows::Foundation::Collections::IKeyValuePair<K,V>> i IObservableMap przekazywanych przez publiczne interfejsy środowisko wykonawcze systemu Windows. Jeśli spróbujesz użyć Platform::Collections::Map typu w publicznej wartości zwracanej lub parametrze, zostanie zgłoszony błąd kompilatora C3986. Błąd można naprawić, zmieniając typ parametru lub zwracaną wartość na Windows::Foundation::Collections::IMap<K,V>.

Aby uzyskać więcej informacji, zobacz Kolekcje.

Członkowie

Konstruktory publiczne

Nazwa/nazwisko	opis
Map::Map	Inicjuje nowe wystąpienie klasy Map.

Metody publiczne

Nazwa/nazwisko	opis
Map::Clear	Usuwa wszystkie pary klucz-wartość z bieżącego obiektu Map.
Map::First	Zwraca iterator, który określa pierwszy element na mapie.
Map::GetView	Zwraca widok tylko do odczytu bieżącej mapy; czyli klasa Platform::Collections::MapView.
Map::HasKey	Określa, czy bieżąca mapa zawiera określony klucz.
Map::Insert	Dodaje określoną parę klucz-wartość do bieżącego obiektu Mapy.
Map::Lookup	Pobiera element w określonym kluczu w bieżącym obiekcie Map.
Map::Remove	Usuwa określoną parę klucz-wartość z bieżącego obiektu Map.
Map::Size	Zwraca liczbę elementów w bieżącym obiekcie Mapy.

Wydarzenia

Nazwa/nazwisko	opis
Map::MapChanged , zdarzenie	Występuje, gdy mapa ulegnie zmianie.

Hierarchia dziedziczenia

Map

Wymagania

Nagłówek: collection.h

Przestrzeń nazw: Platform::Collections

Map::Clear, metoda

Usuwa wszystkie pary klucz-wartość z bieżącego obiektu Map.

Składnia

virtual void Clear();

Map::First, metoda

Zwraca iterator, który określa pierwszy element na mapie lub nullptr jeśli mapa jest pusta.

Składnia

virtual Windows::Foundation::Collections::IIterator<
Windows::Foundation::Collections::IKeyValuePair<K, V>^>^ First();

Wartość zwracana

Iterator określający pierwszy element na mapie.

Uwagi

Wygodnym sposobem przechowywania iteratora zwróconego przez first() jest przypisanie wartości zwracanej do zmiennej zadeklarowanej za pomocą słowa kluczowego auto odliczenia typu. Na przykład auto x = myMap->First();.

Map::GetView, metoda

Zwraca widok tylko do odczytu bieżącej mapy; oznacza to klasę Platform::Collections::MapView, która implementuje interfejs Windows::Foundation::Collections::IMapView<K,V> .

Składnia

Windows::Foundation::Collections::IMapView<K, V>^ GetView();

Wartość zwracana

Obiekt MapView.

Map::HasKey, metoda

Określa, czy bieżąca mapa zawiera określony klucz.

Składnia

bool HasKey(K key);

Parametry

key
Klucz używany do lokalizowania elementu Mapa. Typ klucza to typename K.

Wartość zwracana

true jeśli klucz zostanie znaleziony; w przeciwnym razie, false.

Map::Insert, metoda

Dodaje określoną parę klucz-wartość do bieżącego obiektu Mapy.

Składnia

virtual bool Insert(K key, V value);

Parametry

key
Kluczowa część pary klucz-wartość. Typ klucza to typename K.

wartość
Część wartości pary klucz-wartość. Typ wartości to typename V.

Wartość zwracana

true jeśli klucz istniejącego elementu w bieżącej mapie pasuje do klucza , a część wartości tego elementu jest ustawiona na wartość. falsejeśli żaden istniejący element w bieżącej mapie nie pasuje do klucza, a parametry klucza i wartości są tworzone w parze klucz-wartość, a następnie dodawane do bieżącej mapy.

Map::Lookup, metoda

Pobiera wartość typu V, który jest skojarzony z określonym kluczem typu K, jeśli klucz istnieje.

Składnia

V Lookup(K key);

Parametry

key
Klucz używany do lokalizowania elementu w mapie. Typ klucza to typename K.

Wartość zwracana

Wartość, która jest sparowana z kluczem. Typ wartości zwracanej to typename V.

Uwagi

Jeśli klucz nie istnieje, zostanie zgłoszony wyjątek Platform::OutOfBoundsException .

Map::Map, konstruktor

Inicjuje nowe wystąpienie klasy Map.

Składnia

explicit Map(const C& comp = C());
explicit Map(const StdMap& m);
explicit Map(StdMap&& m ;
template <typename InIt>
Map(
   InItfirst,
   InItlast,
   const C& comp = C());

Parametry

Init
Nazwa typu bieżącej mapy.

Komp
Typ, który udostępnia obiekt funkcji, który może porównać dwie wartości elementów jako klucze sortowania, aby określić ich względną kolejność w mapie.

m
Odwołanie lub wartość rvalue do map Class , która jest używana do inicjowania bieżącej mapy.

Pierwszym
Iterator wejściowy pierwszego elementu w zakresie elementów używanych do inicjowania bieżącej mapy.

Ostatnio
Iterator wejściowy pierwszego elementu po zakresie elementów używanych do inicjowania bieżącej mapy.

Map::MapChanged , zdarzenie

Zgłaszane, gdy element zostanie wstawiony do mapy lub usunięty z niego.

Składnia

event Windows::Foundation::Collections::MapChangedEventHandler<K,V>^ MapChanged;

Wartość właściwości/Zwracana wartość

MapChangedEventHandler<K,V>, który zawiera informacje o obiekcie, który wywołał zdarzenie, oraz rodzaj zmiany, która wystąpiła. Zobacz również Wyliczenie IMapChangedEventArgs<K> i CollectionChange.

Odpowiednik w programie .NET Framework

środowisko wykonawcze systemu Windows aplikacje korzystające z języka C# lub projektu Visual Basic IMap<K,V> jako IDictionary<K,V>.

Map::Remove, metoda

Usuwa określoną parę klucz-wartość z bieżącego obiektu Map.

Składnia

virtual void Remove(K key);

Parametry

key
Kluczowa część pary klucz-wartość. Typ klucza to typename K.

Map::Size, metoda

Zwraca liczbę elementów Windows::Foundation::Collections::IKeyValuePair<K,V> na mapie.

Składnia

virtual property unsigned int Size;

Wartość zwracana

Liczba elementów na mapie.

Zobacz też

Kolekcje (C++/CX)
Przestrzeń nazw platformy
Tworzenie składników środowisko wykonawcze systemu Windows w języku C++