FrameworkElement.FindResource(Object) Yöntem

Tanım

Ad Alanı:
System.Windows
Bütünleştirilmiş Kod:
PresentationFramework.dll

Belirtilen anahtara sahip bir kaynağı arar ve istenen kaynak bulunamazsa bir özel durum oluşturur.

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

Parametreler

resourceKey
Object

İstenen kaynağın anahtar tanımlayıcısı.

Döndürülenler

Object

İstenen kaynak. Sağlanan anahtara sahip bir kaynak bulunamadıysa, bir özel durum oluşturulur. Özel UnsetValue durum durumunda bir değer de döndürülebilir.

Özel durumlar

ResourceReferenceKeyNotFoundException

resourceKey bulunamadı ve olay için UnhandledException bir olay işleyicisi yok.

-veya-

resourceKeybulunamadı ve Handled özelliği olaydafalse.UnhandledException

ArgumentNullException

resourceKey, null'e eşittir.

Örnekler

Aşağıdaki örnek adlandırılmış bir kaynak alır ve bir özelliği doldurmak için uygun bir türe yayınlar.

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

Açıklamalar

Important

Bulunamayan bir anahtar için bu yöntemi çağırırsanız, bir özel durum oluşturulur. çağrısından FindResourcekaynaklanan özel durumları işlemek istemiyorsanız çağrısı TryFindResource yapın. TryFindResource , istenen kaynak bulunamadığında döndürür null ve özel durum oluşturmaz.

Kaynak çağıran öğede bulunamazsa, mantıksal ağaçtaki üst öğe, ardından uygulama, ardından temalar ve son olarak sistem kaynakları aranılır. Bu arama metodolojisi, işaretlemedeki dinamik bir kaynak başvurusu tarafından bir kaynak istendiyse ağacın aranma yöntemiyle aynıdır. Kaynak arama hakkında daha fazla bilgi için bkz. XAML Kaynakları.

Genellikle, döndürülen kaynak değeriyle ayarladığınız özelliğin türüne hemen bir FindResource dönüş değeri yazarsınız.

Kaynak anahtarları mutlaka dize değildir. Örneğin, tema düzeyindeki denetimlerin stilleri, denetimin özellikle anahtarıdır Type ve denetimler için uygulama veya sayfa stilleri genellikle bu anahtar kuralını kullanır. Ayrıntılar için bkz. Stil Oluşturma ve Şablon Oluşturma veya XAML Kaynakları.

Şunlara uygulanır

Ayrıca bkz.