FrameworkElement.TryFindResource(Object) Méthode

Définition

Recherche une ressource avec la clé spécifiée et retourne cette ressource si elle est trouvée.Searches for a resource with the specified key, and returns that resource if found.

public:
 System::Object ^ TryFindResource(System::Object ^ resourceKey);
public object TryFindResource (object resourceKey);
member this.TryFindResource : obj -> obj
Public Function TryFindResource (resourceKey As Object) As Object

Paramètres

resourceKey
Object

Identificateur de clé de la ressource à rechercher.The key identifier of the resource to be found.

Retours

Ressource trouvée ou null si aucune ressource avec l'argument key n'est trouvée.The found resource, or null if no resource with the provided key is found.

Exemples

L’exemple suivant est implémenté en tant que gestionnaire de bouton, où l’utilisateur clique sur le bouton, définit son arrière-plan sur un pinceau défini par la ressource obtenu en appelant TryFindResource sur lui-même.The following example is implemented as a button handler, where the button being clicked sets its background to a resource-defined brush obtained by calling TryFindResource on itself. Vous parcourez l’arborescence d’éléments et recherchez la ressource (la ressource elle-même est définie dans XAMLXAML et n’est pas affichée).This walks the element tree and finds the resource (the resource itself is defined in XAMLXAML and is not shown).

void TryFind(object sender, RoutedEventArgs e)  {
    Button b = e.Source as Button;
    b.Background = (Brush)b.TryFindResource("customBrush");
}    
Private Sub TryFind(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Dim b As Button = TryCast(e.Source, Button)
    b.Background = CType(b.TryFindResource("customBrush"), Brush)
End Sub

Remarques

Si la ressource est introuvable sur l’élément appelant, l’arborescence de ressources parente effectue une recherche vers le haut dans l’arborescence logique, de la même façon que l’arborescence est recherchée si une ressource a été demandée par clé au moment de l’exécution.If the resource is not found on the calling element, the parent resource tree is searched upward through the logical tree, in the same way that the tree would be searched if a resource were requested by key at run time. La méthode retourne null uniquement si aucune ressource de cette clé n’existait n’importe où dans l’arborescence de ressources, conformément aux conditions existantes de l’arborescence au moment de l’appel de TryFindResource.The method returns null only if no resource of that key existed anywhere in the resource tree, per the existing conditions of the tree at the time that TryFindResource is called.

En général, vous effectuez immédiatement un cast de la valeur de retour vers le type de la propriété que vous tentiez de définir avec la valeur de ressource retournée.Typically you would immediately cast the return value to the type of the property that you were attempting to set with the returned resource value.

La méthode FindResource a un comportement similaire, à ceci près qu’elle lève une exception si aucune ressource avec la clé fournie n’a été retournée.The FindResource method has similar behavior, except that it throws an exception if no resource with the provided key was returned.

S’applique à

Voir aussi