FrameworkContentElement.FindResource(Object) Metode

Definisi

Ruang nama:

System.Windows

Rakitan:

PresentationFramework.dll

Mencari sumber daya dengan kunci yang ditentukan, dan akan 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 sumber daya yang akan ditemukan.

Mengembalikan

Object

Sumber daya yang ditemukan, atau null jika tidak ada sumber daya yang cocok yang ditemukan (tetapi juga akan melemparkan pengecualian jika null).

Pengecualian

ResourceReferenceKeyNotFoundException

Kunci sumber daya yang diminta tidak ditemukan.

ArgumentNullException

resourceKey adalah null.

Contoh

Contoh berikut menemukan sumber daya seperti yang didefinisikan dalam markup dan menerapkannya ke properti elemen tertentu sebagai respons terhadap peristiwa yang dirutekan.

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

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

Keterangan

Important

Jika Anda memanggil metode ini untuk kunci yang tidak dapat ditemukan, pengecualian akan dilemparkan. Jika Anda tidak ingin menangani pengecualian untuk kasus ini, Anda harus memanggil TryFindResource. TryFindResource null mengembalikan ketika tidak ada sumber daya yang ditemukan, dan tidak melemparkan pengecualian.

Jika sumber daya tidak ditemukan pada elemen panggilan, pohon induk dicari menggunakan pohon logis, dengan cara yang sama seperti pohon akan dicari jika sumber daya diminta oleh kunci pada run-time.

Biasanya Anda akan segera mentransmisikan nilai pengembalian ke jenis properti yang Anda coba atur dengan nilai sumber daya yang dikembalikan.