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

FrameworkElement.Resources propriété

 

Date de publication : novembre 2016

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 de ressources actif défini localement, où chaque ressource est accessible par clé.

Les dictionnaires de ressources qui peuvent être définies entièrement ou partiellement en langage XAML (eXtensible Application Markup Language) 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 de l’application. Placer le dictionnaire de ressources à ce niveau facilite la recherche d’éléments enfants individuels dans la page (ou à partir de n’importe quelle page, dans le cas de l’application). Dans la plupart des scénarios d’application, nous recommandons que les styles être définis comme éléments objet dans un dictionnaire de ressources, ou être 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 concepteurs 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. Cela est différent dans le processus de recherche de ressource réelle, où un élément enfant peut accéder à toutes les ressources définies dans chaque élément parent, la recherche vers le haut de manière récursive.

Ressources peuvent également être référencées par code depuis la collection, mais sachez que les ressources créées dans XAML seront définitivement pas accessibles tant qu’après Loaded est déclenché par l’élément qui déclare le dictionnaire. En fait, les ressources sont analysées de façon asynchrone et pas même le Loaded événement est l’assurance que vous pouvez référencer un XAML défini par la ressource. C’est pourquoi vous devez généralement accéder uniquement aux XAML ressources définies dans le cadre du code au moment de l’exécution, ou par le biais des autres XAML techniques telles que les styles ou les références d’extension de ressource pour les valeurs d’attribut. Lorsque vous accédez aux ressources via le code, c’est globalement équivalent à une référence effectuée à partir de XAML.

Sous-jacent ResourceDictionary prend en charge les méthodes requises pour ajouter, supprimer ou demander des ressources à partir de la collection à l’aide de code. Le Resources propriété est définissable pour prendre en charge le scénario du remplacement complet de la collection de ressources d’un élément à nouveau ou différent ResourceDictionary.

Notez que le XAML syntaxe indiqué n’inclut pas un élément de la ResourceDictionary. Il s’agit d’un exemple de syntaxe de collection implicite ; une balise qui représente l’élément de collection peut être omise. Les éléments sont ajoutés en tant qu’éléments de la collection sont spécifiés à la place. Pour plus d’informations sur les collections implicites et XAML, consultez XAML Syntax In Detail. Un cas où un ResourceDictionary est encore spécifié explicitement comme un élément est si vous introduisez un dictionnaire fusionné, auquel cas il n’existe généralement 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 au sein de chaque ResourceDictionary doit avoir une valeur unique pour le x:Key Directive, qui sert comme clé unique lorsque les valeurs sont extraites de la ResourceDictionary.

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