FrameworkElement.FindResource(Object) Metode

Definisi

Ruang nama:

System.Windows

Rakitan:

PresentationFramework.dll

Mencari sumber daya dengan kunci yang ditentukan, dan melemparkan pengecualian jika sumber daya yang diminta tidak ditemukan.

public:
 System::Object ^ FindResource(System::Object ^ resourceKey);

public object FindResource (object resourceKey);

member this.FindResource : obj -> obj

Public Function FindResource (resourceKey As Object) As Object

Parameter

resourceKey

Object

Pengidentifikasi kunci untuk sumber daya yang diminta.

Mengembalikan

Object

Sumber daya yang diminta. Jika tidak ada sumber daya dengan kunci yang disediakan yang ditemukan, pengecualian akan dilemparkan. Nilai UnsetValue mungkin juga dikembalikan dalam kasus pengecualian.

Pengecualian

ResourceReferenceKeyNotFoundException

resourceKey tidak ditemukan dan penanganan aktivitas tidak ada untuk kejadian tersebut UnhandledException .

-atau-

resourceKey tidak ditemukan dan Handled properti sedang dalam falseUnhandledException kejadian.

ArgumentNullException

resourceKeyadalah null.

Contoh

Contoh berikut mendapatkan sumber daya bernama dan melemparkannya ke jenis yang sesuai untuk mengisi properti.

void SetBGByResource(object sender, RoutedEventArgs e)
{
  Button b = sender as Button;
  b.Background = (Brush)this.FindResource("RainbowBrush");
}

Private Sub SetBGByResource(ByVal sender As Object, ByVal e As RoutedEventArgs)
  Dim b As Button = TryCast(sender, Button)
  b.Background = CType(Me.FindResource("RainbowBrush"), Brush)
End Sub

Keterangan

Penting

Jika Anda memanggil metode ini untuk kunci yang tidak dapat ditemukan, pengecualian akan dilemparkan. Jika Anda tidak ingin menangani pengecualian yang dihasilkan dari panggilan FindResource, panggil TryFindResource sebagai gantinya. TryFindResourcenull mengembalikan ketika sumber daya yang diminta tidak dapat ditemukan, dan tidak melemparkan pengecualian.

Jika sumber daya tidak ditemukan pada elemen panggilan, elemen induk di pohon logis dicari berikutnya, kemudian aplikasi, kemudian tema, dan akhirnya sumber daya sistem. Metodologi pencarian ini identik dengan bagaimana pohon dicari jika sumber daya diminta oleh referensi sumber daya dinamis dalam markup. Untuk informasi selengkapnya tentang pencarian sumber daya, lihat Sumber Daya XAML.

Biasanya, Anda segera melemparkan FindResource nilai pengembalian ke jenis properti yang Anda atur dengan nilai sumber daya yang dikembalikan.

Kunci sumber daya belum tentu string. Misalnya, gaya untuk kontrol di tingkat tema sengaja dikuncarkan ke Type kontrol, dan gaya aplikasi atau halaman untuk kontrol biasanya menggunakan konvensi kunci yang sama ini. Untuk detailnya, lihat Styling dan Templating atau Sumber Daya XAML.

Lihat juga

• TryFindResource(Object)