Exporter (0) Imprimer
Développer tout
Développer Réduire
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

FrameworkElement.FindResource, méthode

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

Espace de noms :  System.Windows
Assembly :  PresentationFramework (dans PresentationFramework.dll)

public Object FindResource(
	Object resourceKey
)

Paramètres

resourceKey
Type : System.Object
Identificateur clé de la ressource demandée.

Valeur de retour

Type : System.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.

ExceptionCondition
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.

Remarque importanteImportant

Si vous appelez cette méthode pour une clé qui est introuvable, une exception est levée. Si vous ne souhaitez pas gérer les exceptions qui résultent de l'appel de FindResource, appelez TryFindResource à la place. TryFindResource retourne null lorsqu'une ressource demandée ne peut pas être trouvée, 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 alors recherché, puis dans l'application, dans les thèmes et enfin dans les ressources système. Cette méthodologie de recherche est identique à celle dans l'arborescence si une ressource a été demandée par une référence à une ressource dynamique dans le balisage. Pour plus d'informations sur la recherche de ressources, consultez Ressources XAML.

En général, vous devez immédiatement caster une valeur de retour FindResource en type correspondant à celui de la propriété à laquelle vous affectez la valeur de ressource retournée.

Les clés de ressource ne sont pas nécessairement des chaînes. Par exemple, les styles pour des contrôles au niveau du thème se voient délibérément attribués du même Type que le contrôle ; les styles des contrôles issus de l'application ou des pages utilisent en général cette même convention de clé. Pour plus d'informations, consultez Application d'un style et création de modèles ou Ressources XAML.

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


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


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft