FrameworkContentElement.FindResource(Object) Méthode

Définition

Espace de noms:

System.Windows

Assembly:

PresentationFramework.dll

Recherche une ressource avec 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 de clé de la ressource à rechercher.

Retours

Object

Ressource trouvée, ou null si aucune ressource correspondante n’a été trouvée (mais lève également une exception si null).

Exceptions

ResourceReferenceKeyNotFoundException

La clé de ressource demandée est introuvable.

ArgumentNullException

resourceKey a la valeur null.

Exemples

L’exemple suivant recherche une ressource telle que définie dans le balisage et l’applique à une certaine propriété d’un élément en réponse à un événement routé.

void SetBGByResource(object sender, RoutedEventArgs e)
{
    Block b = sender as Block;
    b.Background = (Brush)this.FindResource("RainbowBrush");
}

Private Sub SetBGByResource(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Dim b As Block = TryCast(sender, Block)
    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 pour ce cas, vous devez plutôt appeler TryFindResource. TryFindResource retourne null quand aucune ressource n’est trouvée et ne lève pas d’exception.

Si la ressource est introuvable sur l’élément appelant, l’arborescence parente est recherchée à l’aide de l’arborescence logique, de la même façon que l’arborescence sera recherchée si une ressource a été demandée par clé au moment de l’exécution.

En règle générale, vous effectuez immédiatement un cast de la valeur de retour vers le type de la propriété que vous essayez de définir avec la valeur de ressource retournée.