FrameworkContentElement.Resources Properti

Definisi

Ruang nama:

System.Windows

Rakitan:

PresentationFramework.dll

Mendapatkan atau mengatur kamus sumber daya yang ditentukan secara lokal saat ini.

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

Sumber daya yang ditentukan secara lokal saat ini. Ini adalah kamus sumber daya, di mana sumber daya dalam kamus diakses oleh kunci.

Atribut

AmbientAttribute

Contoh

Contoh berikut menetapkan Resources koleksi pada elemen akar FlowDocument . FlowDocument adalah pilihan umum karena ini adalah salah satu dari beberapa FrameworkContentElement kelas yang masuk akal sebagai elemen akar, dan sumber daya umumnya disimpan di akar halaman atau pada tingkat yang lebih tinggi seperti dalam aplikasi.

<FlowDocument
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  x:Class=" SDKSample.Page2">
  <FlowDocument.Resources>
    <Style TargetType="{x:Type Paragraph}" x:Key="BluePara">
      <Setter Property="Background" Value="Blue"/>
      <Setter Property="FontSize" Value="18"/>
      <Setter Property="Foreground" Value="LightBlue"/>
      <Setter Property="FontFamily" Value="Trebuchet MS"/>
    </Style>
  </FlowDocument.Resources>
  <Paragraph Style="{StaticResource BluePara}">Lorem ipsum etc.</Paragraph>
</FlowDocument>

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 akar untuk halaman individual atau untuk aplikasi. Menempatkan kamus sumber daya pada tingkat ini memudahkan untuk menemukan dari elemen anak 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 dirujuk oleh kode dari dalam koleksi, tetapi ketahuilah bahwa sumber daya yang dibuat di XAML pasti tidak akan dapat diakses sampai setelah Loaded dinaikkan oleh elemen yang mendeklarasikan kamus. Bahkan, sumber daya diurai secara asinkron, dan bahkan peristiwa tersebut Loaded bukan 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. Resources Properti dapat diatur untuk mendukung skenario sepenuhnya menggantikan kumpulan sumber daya elemen menjadi baru atau berbedaResourceDictionary.

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 Rinci. 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