ResourceDictionary.MergedDictionaries Properti

Definisi

Ruang nama:

Windows.UI.Xaml

Mendapatkan kumpulan kamus ResourceDictionary yang merupakan berbagai kamus sumber daya dalam kamus gabungan.

public:
 property IVector<ResourceDictionary ^> ^ MergedDictionaries { IVector<ResourceDictionary ^> ^ get(); };

IVector<ResourceDictionary> MergedDictionaries();

public IList<ResourceDictionary> MergedDictionaries { get; }

var iVector = resourceDictionary.mergedDictionaries;

Public ReadOnly Property MergedDictionaries As IList(Of ResourceDictionary)

<ResourceDictionary>
  <ResourceDictionary.MergedDictionaries>
    oneOrMoreResourceDictionaryElements
  </ResourceDictionary.MergedDictionaries>
</ResourceDictionary>

Nilai Properti

IVector<ResourceDictionary>

IList<ResourceDictionary>

Kumpulan daftar kamus ResourceDictionary yang merupakan berbagai kamus sumber daya dalam kamus gabungan.

Contoh

Templat Microsoft Visual Studio awal untuk aplikasi UWP menggunakan C++, C#, atau Visual Basic menyertakan node MergedDictionaries dalam file app.xaml. Ini mereferensikan ResourceDictionary XAML terpisah dalam proyek yang berisi beberapa definisi templat kontrol dasar. Anda dapat memodifikasi XAML dalam ResourceDictionary untuk menyesuaikan tampilan kontrol Anda.

<Application
    ....
>
    <Application.Resources>
        <ResourceDictionary>
            <ResourceDictionary.MergedDictionaries>
                <ResourceDictionary Source="Common/StandardStyles.xaml"/>
            </ResourceDictionary.MergedDictionaries>
        </ResourceDictionary>
    </Application.Resources>
</Application>

Keterangan

Mengatur nilai MergedDictionaries memungkinkan Anda berbagi file XAML ResourceDictionary di antara beberapa halaman, atau juga sebagai file umum yang mungkin Anda tambahkan ke beberapa proyek aplikasi. Ini menyediakan teknik pemfaktoran dan penggunaan kembali yang berguna untuk sumber daya dari sudut pemanfaatan pengembangan dan desain. Anda biasanya menyertakan file XAML sebagai item Konten sebagai bagian dari proyek dan manifes aplikasi.

Sumber daya utama dalam XAML MergedDictionaries tidak harus unik versus kunci seperti yang ditemukan di ResourceDictionary utama untuk Application.Resources atau FrameworkElement.Resources, dan urutan pencarian untuk kunci akan terlihat di kamus utama terlebih dahulu. Ini memungkinkan teknik di mana Anda dapat mengambil alih nilai kunci apa pun yang diperoleh dari dalam file XAML MergedDictionaries, tetapi Anda juga dapat memiliki kamus gabungan yang tersedia sebagai fallback atau sebagai sekumpulan umum sumber daya yang tidak disesuaikan.

Anda dapat menyertakan lebih dari satu ResourceDictionary dalam MergedDictionaries yang diatur untuk memberikan urutan fallback bahkan dalam kumpulan MergedDictionaries.

Untuk informasi selengkapnya tentang cara menggunakan MergedDictionaries dan urutan pencarian sumber daya, lihat Referensi sumber daya ResourceDictionary dan XAML.

ThemeDictionaries adalah properti terkait yang juga menggabungkan sumber Kamus Sumber Daya XAML tambahan ke dalam kumpulan sumber daya kunci secara keseluruhan, di mana skenarionya adalah untuk menyediakan sumber daya terkait tema untuk kontrol.

Mengubah konten kumpulan item ResourceDictionary untuk MergedDictionaries bukanlah skenario umum. Umumnya Anda membuat konten koleksi di XAML dan tidak mengubahnya saat runtime. Tidak ada banyak skenario di mana Anda akan mengakses koleksi itu sendiri dalam kode run-time. Biasanya Anda mengandalkan pencarian sumber daya bawaan yang terjadi pada waktu pemuatan XAML, atau Anda mengkueri koleksi Application.Resources atau FrameworkElement.Resources yang relevan yang dapat mereferensikan sumber daya berdasarkan kunci, termasuk sumber daya gabungan.

Lihat juga

• Referensi sumber daya ResourceDictionary dan XAML