Application.FindResource(Object) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Vyhledá prostředek uživatelského rozhraní (UI), například Style prostředek nebo Brushs zadaným klíčem, a vyvolá výjimku, pokud požadovaný prostředek nenajde (viz prostředky XAML).
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
Název prostředku, který chcete najít.
Návraty
Požadovaný objekt prostředku. Pokud požadovaný prostředek nebyl nalezen, ResourceReferenceKeyNotFoundException vyvolá se vyvolání.
Výjimky
Prostředek nebyl nalezen.
Příklady
Následující příklad ukazuje, jak pomocí FindResource najít prostředek a zpracovat ResourceReferenceKeyNotFoundException , pokud se prostředek nenajde.
void findResourceButton_Click(object sender, RoutedEventArgs e) {
try {
object resource = Application.Current.FindResource("UnfindableResource");
}
catch (ResourceReferenceKeyNotFoundException ex) {
MessageBox.Show("Resource not found.");
}
}
Private Sub findResourceButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
Try
Dim resource As Object = Application.Current.FindResource("UnfindableResource")
Catch ex As ResourceReferenceKeyNotFoundException
MessageBox.Show("Resource not found.")
End Try
End Sub
Poznámky
FindResource nejprve se podívá do prostředků oboru aplikace pro zadaný prostředek. Prostředky v oboru aplikace jsou spravovány pomocí Applicationa jsou vystaveny z Resources vlastnosti. Pokud zadaný prostředek není v sadě prostředků oboru aplikace nalezen, FindResource pak další prohledá systémové prostředky. Systémové prostředky jsou prostředky prostředí definované uživatelem a zahrnují barvy, písma a konfigurace prostředí. Ty jsou vystaveny z SystemColors, SystemFontsa SystemParameters typy, v uvedeném pořadí, jako statické vlastnosti. Chcete-li je získat FindResource , tyto typy také zveřejňují vlastnosti klíče prostředku, které jsou navrženy tak, aby byly předány FindResource, IconWidthKeynapříklad .
Vzhledem k tomu FindResource , že vrací objekt, je nutné přetypovat vrácenou hodnotu na příslušný typ, pokud je nalezen prostředek.
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, místo toho volání TryFindResource ; TryFindResource vrátí null odkaz, pokud požadovaný prostředek nelze najít a nevyvolá výjimku.
Tato metoda je bezpečná pro vlákno a lze ji volat z libovolného vlákna.