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:
integers
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.
Elementy członkowskie
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. |
Zdarzenia
| 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.
pierwszy
Iterator wejściowy pierwszego elementu w zakresie elementów używanych do inicjowania bieżącej mapy.
ostatni
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++