Application.FindResource(Object) Méthode

Définition

Espace de noms:

System.Windows

Assembly:

PresentationFramework.dll

Recherche une ressource d’interface utilisateur (IU), telle qu’une Style ou Brush, avec la clé spécifiée, et lève une exception si la ressource demandée est introuvable (voir Ressources 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

Paramètres

resourceKey

Object

Nom de la ressource à rechercher.

Retours

Object

Objet de ressource demandé. Si la ressource demandée est introuvable, une ResourceReferenceKeyNotFoundException valeur est levée.

Exceptions

ResourceReferenceKeyNotFoundException

La ressource est introuvable.

Exemples

L’exemple suivant montre comment rechercher FindResource une ressource et gérer ResourceReferenceKeyNotFoundException si la ressource est introuvable.

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

Remarques

FindResource recherche d’abord les ressources d’étendue de l’application pour la ressource spécifiée. Les ressources d’étendue d’application sont gérées par Application, et sont exposées à partir de la Resources propriété. Si la ressource spécifiée n’est pas trouvée dans l’ensemble de ressources d’étendue d’application, FindResource recherche ensuite les ressources système. Les ressources système sont des ressources shell définies par l’utilisateur et incluent des couleurs, des polices et des configurations d’interpréteur de commandes. Celles-ci sont exposées à partir des SystemColorstypes, SystemFontsrespectivement SystemParameters , sous forme de propriétés statiques. FindResource Pour les acquérir, ces types exposent également les propriétés de clé de ressource conçues pour être passées à FindResource; par exemple. IconWidthKey

Étant donné que FindResource retourne un objet, vous devez convertir la valeur retournée en type approprié si la ressource est trouvée.

Important

Si vous appelez cette méthode pour une clé introuvable, une exception est levée. Si vous ne souhaitez pas gérer les exceptions résultant de l’appel FindResource, appelez TryFindResource à la place ; TryFindResource retourne une null référence lorsqu’une ressource demandée est introuvable et ne lève pas d’exception.

Cette méthode est thread safe et peut être appelée à partir de n’importe quel thread.

Voir aussi

• TryFindResource(Object)