Resources Propriété
Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Propriété FrameworkElement.Resources

 

Obtient ou définit le dictionnaire de ressources défini localement.

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

[AmbientAttribute]
public ResourceDictionary Resources { get; set; }

Valeur de propriété

Type: System.Windows.ResourceDictionary

Dictionnaire actif défini localement pour les ressources, où chaque ressource peut être accédée par clé.

Les dictionnaires de ressources qui peuvent être complètement ou partiellement définis en Extensible Application Markup Language (XAML) sont créés en général comme un élément de propriété et sont en général à l'élément racine pour toute page individuelle ou pour l'application.Placer le dictionnaire de ressources à ce niveau simplifie la recherche d'éléments enfants individuels dans la page (ou de toute page, dans le cas d'une application).Dans la plupart des scénarios d'application, nous recommandons que les styles soient définis comme éléments objet dans un dictionnaire de ressources, ou soit définis comme ressources externes afin que la ressource de style entière puisse être autonome (cette approche permet de séparer les responsabilités du concepteur de celles du développeur en séparant les fichiers physiques qui doivent être modifiés).

Notez que cette propriété retourne uniquement le dictionnaire de ressources déclaré directement dans cet élément.C'est différent du processus actuel de recherche de ressources, où un élément enfant peut accéder à toutes les ressources définies dans chaque élément parent, en recherchant vers le haut de manière récursive.

Les ressources peuvent également être référencées par code depuis la collection, mais sachez que les ressources créées en XAML ne sont pas du tout accessibles tant que Loaded n'a pas été déclenché par l'élément qui déclare le dictionnaire.En fait, les ressources sont analysées de façon asynchrone. L'événement Loaded ne constitue pas en soi l'assurance que vous pouvez référencer une ressource XAML définie.Pour cette raison, vous devez accéder en général uniquement aux ressources XAML définies dans le cadre du code au moment de l'exécution, ou par le biais d'autres techniques XAML comme les styles ou les références d'extension de ressource les valeurs d'attribut.Lorsque vous accédez aux ressources à travers le code, c'est globalement équivalent à une référence effectuée depuis XAML.

L'objet ResourceDictionary sous-jacent prend en charge les méthodes requises pour ajouter, supprimer ou demander des ressources à partir de la collection en utilisant du code.La propriété Resources peut être définie de façon à prendre en charge le scénario du remplacement complet de la collection de ressources d'un élément en ResourceDictionary nouveau ou différent.

Remarquez que la syntaxe XAML montrée n'inclut pas d'élément pour le ResourceDictionary.C'est un exemple de syntaxe de collection implicite ; une balise qui représente l'élément de collection peut être omise.Les éléments ajoutés comme éléments à la collection sont spécifiés à la place.Pour plus d'informations sur les collections implicites et XAML, consultez Syntaxe XAML en détail.Un cas où un ResourceDictionary est encore spécifié explicitement comme un élément se produit si vous introduisez un dictionnaire fusionné, auquel cas il n'y a en général aucun élément enfant pour ce ResourceDictionary.Pour plus d'informations, consultez Dictionnaires de ressources fusionnés.

<object>
  <object.Resources>
    oneOrMoreResourceElements
  </object.Resources>
</object>

oneOrMoreResourceElements

Un ou plusieurs éléments objet, chacun d'entre eux définissant une ressource.Chaque élément de propriété de ressource dans chaque ResourceDictionary doit avoir une valeur unique pour le x:Key – direktiva, qui sert comme clé unique lorsque les valeurs sont récupérées du ResourceDictionary.

.NET Framework
Disponible depuis 3.0
Silverlight
Disponible depuis 2.0
Windows Phone Silverlight
Disponible depuis 7.0
Retour au début
Afficher:
© 2016 Microsoft