Platform::Collections::Map Sınıfı
Anahtar-değer çiftleri koleksiyonu olan bir eşlemeyi temsil eder. XAML veri bağlamaya yardımcı olmak için Windows::Foundation::Collections::IObservableMap uygular.
Sözdizimi
template <
typename K,
typename V,
typename C = std::less<K>>
ref class Map sealed;
Parametreler
K
Anahtar-değer çiftindeki anahtarın türü.
V
Anahtar-değer çiftindeki değerin türü.
C
İki öğe değerini Eşleme'deki göreli düzenlerini belirlemek için sıralama anahtarları olarak karşılaştırabilen bir işlev nesnesi sağlayan tür. Varsayılan olarak, std::less<K>.
__is_valid_winrt_type() K ve V türlerini doğrulayan ve tür Eşlem'de depolanamıyorsa kolay bir hata iletisi sağlayan derleyici tarafından oluşturulan bir işlevdir.
Açıklamalar
İzin verilen türler şunlardır:
integers
interface class^
public ref class^
değer yapısı
public sabit listesi sınıfı
Harita temelde std::map için bir sarmalayıcıdır. Genel Windows Çalışma Zamanı arabirimleri arasında geçirilen Windows::Foundation::Collections::IMap<Windows::Foundation::Collections::IKeyValuePair<K,V>> ve IObservableMap türlerinin C++ somut bir uygulamasıdır. Genel dönüş değeri veya parametresinde bir Platform::Collections::Map tür kullanmaya çalışırsanız, derleyici hatası C3986 oluşur. Parametrenin türünü değiştirerek veya dönüş değerini Windows::Foundation::Collections::IMap<K,V> olarak değiştirerek hatayı düzeltebilirsiniz.
Daha fazla bilgi için bkz . Koleksiyonlar.
Üyeler
Ortak Oluşturucular
| Veri Akışı Adı | Açıklama |
|---|---|
| Harita::Harita | Map sınıfının yeni bir örneğini başlatır. |
Genel Yöntemler
| Veri Akışı Adı | Açıklama |
|---|---|
| Harita::Temizle | Geçerli Map nesnesinden tüm anahtar-değer çiftlerini kaldırır. |
| Harita::İlk | Eşlemedeki ilk öğeyi belirten bir yineleyici döndürür. |
| Harita::GetView | Geçerli Haritanın salt okunur görünümünü döndürür; yani Platform ::Collections::MapView Sınıfı. |
| Map::HasKey | Geçerli Eşlemenin belirtilen anahtarı içerip içermediğini belirler. |
| Harita::Ekle | Belirtilen anahtar-değer çiftini geçerli Map nesnesine ekler. |
| Harita::Arama | Geçerli Map nesnesinde belirtilen anahtardaki öğesini alır. |
| Harita::Kaldır | Belirtilen anahtar-değer çiftini geçerli Map nesnesinden siler. |
| Harita::Boyut | Geçerli Map nesnesindeki öğe sayısını döndürür. |
Ekinlikler
| Veri Akışı Adı | Açıklama |
|---|---|
| Map::MapChanged olayı | Eşleme değiştiğinde gerçekleşir. |
Devralma Hiyerarşisi
Map
Gereksinimler
Üst bilgi: collection.h
Ad Alanı: Platform::Collections
Map::Clear Yöntemi
Geçerli Map nesnesinden tüm anahtar-değer çiftlerini kaldırır.
Sözdizimi
virtual void Clear();
Map::First Yöntemi
Eşlemedeki ilk öğeyi veya nullptr haritanın boş olup olmadığını belirten bir yineleyici döndürür.
Sözdizimi
virtual Windows::Foundation::Collections::IIterator<
Windows::Foundation::Collections::IKeyValuePair<K, V>^>^ First();
Dönüş Değeri
Eşlemedeki ilk öğeyi belirten bir yineleyici.
Açıklamalar
First() tarafından döndürülen yineleyiciyi tutmanın kullanışlı bir yolu, dönüş değerini tür kesinti anahtar sözcüğüyle bildirilen bir değişkene auto atamaktır. Örneğin, auto x = myMap->First();.
Map::GetView Yöntemi
Geçerli Haritanın salt okunur görünümünü döndürür; yani, Windows::Foundation::Collections::IMapView K,V> arabirimini uygulayan bir Platform::Collections::MapView<Sınıfı.
Sözdizimi
Windows::Foundation::Collections::IMapView<K, V>^ GetView();
Dönüş Değeri
Bir MapView nesnesi.
Map::HasKey Yöntemi
Geçerli Eşlemenin belirtilen anahtarı içerip içermediğini belirler.
Sözdizimi
bool HasKey(K key);
Parametreler
key
Map öğesini bulmak için kullanılan anahtar. Anahtarın türü K tür adıdır.
Dönüş Değeri
true anahtar bulunursa; aksi takdirde , false.
Map::Insert Yöntemi
Belirtilen anahtar-değer çiftini geçerli Map nesnesine ekler.
Sözdizimi
virtual bool Insert(K key, V value);
Parametreler
key
Anahtar-değer çiftinin anahtar kısmı. Anahtarın türü K tür adıdır.
value
Anahtar-değer çiftinin değer bölümü. Değer türü V tür adıdır.
Dönüş Değeri
truegeçerli Eşlemedeki mevcut bir öğenin anahtarı anahtarla eşleşiyorsa ve bu öğenin değer bölümü değer olarak ayarlandıysa. falsegeçerli Eşlemede mevcut bir öğe anahtarla eşleşmiyorsa ve anahtar ve değer parametreleri bir anahtar-değer çifti haline getirilip geçerli Eşlem'e eklenir.
Map::Lookup Yöntemi
Anahtar varsa, belirtilen K türündeki anahtarla ilişkili V türünün değerini alır.
Sözdizimi
V Lookup(K key);
Parametreler
key
Map içindeki bir öğeyi bulmak için kullanılan anahtar. Anahtarın türü K tür adıdır.
Dönüş Değeri
Anahtarla eşleştirilen değer. Dönüş değerinin türü V tür adıdır.
Açıklamalar
Anahtar yoksa Platform ::OutOfBoundsException oluşturulur.
Harita::Harita Oluşturucu
Map sınıfının yeni bir örneğini başlatır.
Sözdizimi
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());
Parametreler
Init
Geçerli Eşlemenin tür adı.
Comp
İki öğe değerini Eşleme'deki göreli düzenlerini belirlemek için sıralama anahtarları olarak karşılaştırabilen bir işlev nesnesi sağlayan tür.
m
Geçerli Eşlemeyi başlatmak için kullanılan bir map Class başvuru veya rvalue.
birinci
Geçerli Eşlemeyi başlatmak için kullanılan bir öğe aralığındaki ilk öğenin giriş yineleyicisi.
son
Geçerli Eşlemeyi başlatmak için kullanılan bir öğe aralığından sonraki ilk öğenin giriş yineleyicisi.
Map::MapChanged Olayı
Bir öğe haritaya eklendiğinde veya haritadan kaldırıldığında oluşturulur.
Sözdizimi
event Windows::Foundation::Collections::MapChangedEventHandler<K,V>^ MapChanged;
Özellik Değeri/Dönüş Değeri
Olayı oluşturan nesne ve gerçekleşen değişiklik türü hakkında bilgi içeren mapChangedEventHandler<K,V> . Ayrıca bkz. IMapChangedEventArgs<K> ve CollectionChange Numaralandırması.
.NET Framework Eşdeğeri
C# veya Visual Basic projesi IMap< kullanan uygulamaları Windows Çalışma ZamanıK,V> as IDictionary<K,V>.
Map::Remove Yöntemi
Belirtilen anahtar-değer çiftini geçerli Map nesnesinden siler.
Sözdizimi
virtual void Remove(K key);
Parametreler
key
Anahtar-değer çiftinin anahtar kısmı. Anahtarın türü K tür adıdır.
Map::Size Yöntemi
Haritadaki Windows::Foundation::Collections::IKeyValuePair K,V> öğelerinin sayısını döndürür.<
Sözdizimi
virtual property unsigned int Size;
Dönüş Değeri
Harita'daki öğelerin sayısı.
Ayrıca bkz.
Koleksiyonlar (C++/CX)
Platform Ad Alanı
C++ uygulamasında Windows Çalışma Zamanı Bileşenleri Oluşturma