FrameworkElement.FindResource(Object) Metoda

Definice

Obor názvů:

System.Windows

Sestavení:

PresentationFramework.dll

Vyhledá prostředek se zadaným klíčem a vyvolá výjimku, pokud požadovaný prostředek není nalezen.

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

Parametry

resourceKey

Object

Identifikátor klíče požadovaného prostředku.

Návraty

Object

Požadovaný prostředek. Pokud nebyl nalezen žádný prostředek se zadaným klíčem, vyvolá se výjimka. V UnsetValue případě výjimky může být vrácena také hodnota.

Výjimky

ResourceReferenceKeyNotFoundException

resourceKey nebyl nalezen a obslužná rutina UnhandledException události pro událost neexistuje.

-nebo-

resourceKey nebyl nalezen a Handled vlastnost je false v UnhandledException události.

ArgumentNullException

resourceKey je null.

Příklady

Následující příklad získá pojmenovaný prostředek a přetypuje ho na odpovídající typ pro vyplnění vlastnosti.

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

Poznámky

Důležité

Pokud zavoláte tuto metodu pro klíč, který nelze najít, vyvolá se výjimka. Pokud nechcete zpracovávat výjimky, které jsou výsledkem volání FindResource, zavolejte TryFindResource místo toho. TryFindResource vrátí null , když požadovaný prostředek nelze najít a nevyvolá výjimku.

Pokud prostředek není nalezen ve volajícím elementu, vyhledá se další nadřazený prvek v logickém stromu, pak aplikace, pak motivy a nakonec systémové prostředky. Tato metodologie vyhledávání je shodná s tím, jak se prohledá strom, pokud byl prostředek požadován dynamickým odkazem na prostředek ve značkách. Další informace o vyhledávání prostředků najdete v tématu Prostředky XAML.

Obvykle okamžitě přetypujete návratovou FindResource hodnotu na typ vlastnosti, kterou nastavíte s vrácenou hodnotou prostředku.

Klíče prostředků nemusí být nutně řetězce. Například styly ovládacích prvků na úrovni motivu jsou záměrně zaklíčovány k Type ovládacímu prvku a styly aplikací nebo stránek pro ovládací prvky obvykle používají stejnou konvenci klíče. Podrobnosti najdete v tématu Styling a Templating nebo Prostředky XAML.

Viz také

• TryFindResource(Object)