Application.FindResource(Object) Méthode

Définition

Recherche une ressource d’interface utilisateur, telle qu’une StyleBrushou , 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

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

Exceptions

La ressource est introuvable.

Exemples

L’exemple suivant montre comment utiliser FindResource pour rechercher 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 dans les ressources d’étendue de l’application la ressource spécifiée. Les ressources d’étendue d’application sont gérées par Applicationet sont exposées à partir de la Resources propriété . Si la ressource spécifiée est introuvable dans l’ensemble de ressources d’étendue de l’application, FindResource recherche ensuite les ressources système. Les ressources système sont des ressources d’interpréteur de commandes 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 , SystemFontset SystemParameters , respectivement, en tant que propriétés statiques. Pour les utiliser FindResource pour les acquérir, ces types exposent également des propriétés de clé de ressource conçues pour être transmises à FindResource; par exemple, IconWidthKey.

Étant donné que FindResource retourne un objet, vous devez caster la valeur retournée au 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 qui résultent 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.

S’applique à

Voir aussi