FrameworkElement.FindResource(Object) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Sucht nach einer Ressource mit dem angegebenen Schlüssel und löst eine Ausnahme aus, wenn die angeforderte Ressource nicht gefunden wird.
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
Der Schlüsselbezeichner für die angeforderte Ressource.
Gibt zurück
Die angeforderte Ressource. Wenn keine Ressource mit dem bereitgestellten Schlüssel gefunden wurde, wird eine Ausnahme ausgelöst. Ein UnsetValue Wert kann auch im Ausnahmefall zurückgegeben werden.
Ausnahmen
resourceKey wurde nicht gefunden, und für das UnhandledException Ereignis ist kein Ereignishandler vorhanden.
-oder-
resourceKey wurde nicht gefunden, und die Handled Eigenschaft befindet sich false im UnhandledException Ereignis.
resourceKey ist null.
Beispiele
Das folgende Beispiel ruft eine benannte Ressource ab und wandelt sie in einen geeigneten Typ um, um eine Eigenschaft auszufüllen.
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
Hinweise
Important
Wenn Sie diese Methode für einen Nicht gefundenen Schlüssel aufrufen, wird eine Ausnahme ausgelöst. Wenn Sie keine Ausnahmen behandeln möchten, die von aufrufen FindResource, rufen Sie stattdessen auf TryFindResource .
TryFindResource gibt zurück null , wenn eine angeforderte Ressource nicht gefunden werden kann und keine Ausnahme ausgelöst wird.
Wenn die Ressource für das aufrufende Element nicht gefunden wird, wird das übergeordnete Element in der logischen Struktur als nächstes durchsucht, dann wird die Anwendung, dann Designs und schließlich Systemressourcen gesucht. Diese Nachschlagemethode ist identisch mit der Suche der Struktur, wenn eine Ressource von einem dynamischen Ressourcenverweis im Markup angefordert wurde. Weitere Informationen zur Ressourcensuche finden Sie unter XAML-Ressourcen.
Normalerweise wandeln Sie sofort einen FindResource Rückgabewert in den Typ der Eigenschaft um, die Sie mit dem zurückgegebenen Ressourcenwert festlegen.
Ressourcenschlüssel sind nicht unbedingt Zeichenfolgen. Beispielsweise werden Stile für Steuerelemente auf Designebene absichtlich auf das Type Steuerelement festgelegt, und Anwendungs- oder Seitenformatvorlagen für Steuerelemente verwenden in der Regel dieselbe Schlüsselkonvention. Ausführliche Informationen finden Sie unter "Formatieren und Vorlagen " oder "XAML-Ressourcen".