FrameworkElement.Resources Properti

Definisi

Ruang nama:

System.Windows

Rakitan:

PresentationFramework.dll

Mendapatkan atau mengatur kamus sumber daya yang ditentukan secara lokal.

public:
 property System::Windows::ResourceDictionary ^ Resources { System::Windows::ResourceDictionary ^ get(); void set(System::Windows::ResourceDictionary ^ value); };

[System.Windows.Markup.Ambient]
public System.Windows.ResourceDictionary Resources { get; set; }

[<System.Windows.Markup.Ambient>]
member this.Resources : System.Windows.ResourceDictionary with get, set

Public Property Resources As ResourceDictionary

Nilai Properti

ResourceDictionary

Kamus sumber daya yang ditentukan secara lokal saat ini, di mana setiap sumber daya dapat diakses oleh kunci.

Atribut

AmbientAttribute

Keterangan

Kamus sumber daya yang dapat didefinisikan sepenuhnya atau sebagian dalam Extensible Application Markup Language (XAML) biasanya dibuat sebagai elemen properti, dan biasanya berada di elemen root untuk halaman individual atau untuk aplikasi. Menempatkan kamus sumber daya pada tingkat ini memudahkan untuk menemukan dari elemen turunan individual di halaman (atau dari halaman mana pun, dalam kasus aplikasi). Dalam sebagian besar skenario aplikasi, kami menyarankan agar gaya didefinisikan sebagai elemen objek dalam kamus sumber daya, atau didefinisikan sebagai sumber daya eksternal sehingga seluruh sumber daya gaya dapat mandiri (pendekatan ini membantu memisahkan tanggung jawab perancang dari tanggung jawab pengembang dengan memisahkan file fisik yang perlu diedit).

Perhatikan bahwa properti ini hanya mengembalikan kamus sumber daya yang dideklarasikan langsung dalam elemen tersebut. Ini berbeda dari proses pencarian sumber daya aktual, di mana elemen anak dapat mengakses salah satu sumber daya yang ditentukan di setiap elemen induk, mencari secara rekursif ke atas.

Sumber daya juga dapat direferensikan oleh kode dari dalam koleksi, tetapi ketahuilah bahwa sumber daya yang dibuat di XAML pasti tidak akan dapat diakses sampai setelah Loaded dimunculkan oleh elemen yang mendeklarasikan kamus. Bahkan, sumber daya diurai secara asinkron dan bahkan Loaded tidak peristiwa tersebut adalah jaminan bahwa Anda dapat mereferensikan sumber daya yang ditentukan XAML. Untuk alasan ini, Anda umumnya hanya boleh mengakses sumber daya yang ditentukan XAML sebagai bagian dari kode run-time, atau melalui teknik XAML lainnya seperti gaya atau referensi ekstensi sumber daya untuk nilai atribut. Ketika Anda mengakses sumber daya melalui kode, pada dasarnya setara dengan referensi DynamicResource yang dibuat dari XAML.

Yang mendasar ResourceDictionary mendukung metode yang diperlukan untuk menambahkan, menghapus, atau mengkueri sumber daya dari dalam koleksi dengan menggunakan kode. Properti Resources dapat diatur untuk mendukung skenario menggantikan sepenuhnya kumpulan sumber daya dari elemen menjadi baru atau berbeda ResourceDictionary.

Perhatikan bahwa sintaks XAML yang ditampilkan tidak menyertakan elemen untuk ResourceDictionary. Ini adalah contoh sintaks pengumpulan implisit; tag yang mewakili elemen koleksi dapat dihilangkan. Elemen yang ditambahkan sebagai item ke koleksi ditentukan sebagai gantinya. Untuk informasi selengkapnya tentang koleksi implisit dan XAML, lihat Sintaks XAML Secara Terperinci. Satu kasus di mana ResourceDictionary masih ditentukan secara eksplisit sebagai elemen adalah jika Anda memperkenalkan kamus gabungan, dalam hal ini biasanya tidak ada elemen anak untuk itu ResourceDictionary. Untuk detailnya, lihat Kamus Sumber Daya Gabungan.

Penggunaan Elemen Properti XAML

<object>  
  <object.Resources>  
    oneOrMoreResourceElements  
  </object.Resources>  
</object>  

Nilai XAML

oneOrMoreResourceElements
Satu atau beberapa elemen objek, yang masing-masing mendefinisikan sumber daya. Setiap elemen properti sumber daya dalam masing-masing ResourceDictionary harus memiliki nilai unik untuk x:Key Directive, yang berfungsi sebagai kunci unik ketika nilai diambil dari ResourceDictionary.

Lihat juga

• Resources
• x:Atribut Kunci