Application.FindResource(Object) Methode

Definition

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Sucht nach einer Benutzeroberflächesressource, z. B. einem oder Brusheinem Style , mit dem angegebenen Schlüssel, und löst eine Ausnahme aus, wenn die angeforderte Ressource nicht gefunden wird (siehe XAML-Ressourcen).

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 Name der zu suchenden Ressource.

Gibt zurück

Object

Das angeforderte Ressourcenobjekt. Wenn die angeforderte Ressource nicht gefunden werden kann, wird eine ResourceReferenceKeyNotFoundException ausgelöst.

Ausnahmen

ResourceReferenceKeyNotFoundException

Die Ressource wurde nicht gefunden.

Beispiele

Im folgenden Beispiel wird gezeigt, wie FindResource Sie eine Ressource finden und ResourceReferenceKeyNotFoundException behandeln können, wenn die Ressource nicht gefunden wird.

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

Hinweise

FindResource sucht zuerst in Anwendungsbereichsressourcen für die angegebene Ressource. Anwendungsbereichsressourcen werden von Applicationder Eigenschaft verwaltet und werden von der Resources Eigenschaft verfügbar gemacht. Wenn die angegebene Ressource im Satz von Anwendungsbereichsressourcen nicht gefunden wird, FindResource durchsucht die nächsten Die Systemressourcen. Systemressourcen sind Shellressourcen, die vom Benutzer definiert sind, und enthalten Farben, Schriftarten und Shellkonfigurationen. Diese werden von den SystemColorsSystemFontsSystemParameters Typen und Typen als statische Eigenschaften verfügbar gemacht. FindResource Um sie zu erwerben, machen diese Typen auch Ressourcenschlüsseleigenschaften verfügbar, die an ; zIconWidthKey. B. übergeben FindResourcewerden sollen.

Da FindResource ein Objekt zurückgegeben wird, müssen Sie den zurückgegebenen Wert in den entsprechenden Typ umwandeln, wenn die Ressource gefunden wird.

Wichtig

Wenn Sie diese Methode für einen Schlüssel aufrufen, der nicht gefunden werden kann, wird eine Ausnahme ausgelöst. Wenn Sie keine Ausnahmen behandeln möchten, die von aufrufen FindResource, rufen Sie stattdessen auf TryFindResource ; TryFindResource gibt einen null Verweis zurück, wenn eine angeforderte Ressource nicht gefunden werden kann, und löst keine Ausnahme aus.

Diese Methode ist threadsicher und kann von jedem Thread aufgerufen werden.

Siehe auch

• TryFindResource(Object)