FrameworkElement.FindResource(Object) Méthode

Définition

Espace de noms:

System.Windows

Assembly:

PresentationFramework.dll

Recherche une ressource d'après la clé spécifiée et lève une exception si la ressource demandée est introuvable.

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

Identificateur clé de la ressource demandée.

Retours

Object

Ressource demandée. Si aucune ressource n'est trouvée avec la clé indiquée, une exception est levée. Une valeur UnsetValue peut également être retournée dans le cas d'une exception.

Exceptions

ResourceReferenceKeyNotFoundException

resourceKey était introuvable et un gestionnaire d'événements n'existe pas pour l'événement UnhandledException.

- ou -

resourceKey était introuvable et la propriété Handled est false dans l'événement UnhandledException.

ArgumentNullException

resourceKey a la valeur null.

Exemples

L’exemple suivant obtient une ressource nommée et la caste en un type approprié pour remplir une propriété.

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

Remarques

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 FindResourcede , appelez TryFindResource à la place. TryFindResource retourne null lorsqu’une ressource demandée est introuvable et ne lève pas d’exception.

Si la ressource est introuvable sur l’élément appelant, l’élément parent dans l’arborescence logique est ensuite recherché, puis l’application, les thèmes et enfin les ressources système. Cette méthodologie de recherche est identique à la façon dont l’arborescence est recherchée si une ressource a été demandée par une référence de ressource dynamique dans le balisage. Pour plus d’informations sur la recherche de ressources, consultez Ressources XAML.

En règle générale, vous castez immédiatement une FindResource valeur de retour en type de la propriété que vous définissez avec la valeur de ressource retournée.

Les clés de ressource ne sont pas nécessairement des chaînes. Par instance, les styles des contrôles au niveau du thème sont délibérément liés au Type du contrôle, et les styles d’application ou de page pour les contrôles utilisent généralement cette même convention de clé. Pour plus d’informations, consultez Styles et création de modèles ou Ressources XAML.

Voir aussi

• TryFindResource(Object)