FrameworkElement.Resources Propriété

Définition

Espace de noms:

System.Windows

Assembly:

PresentationFramework.dll

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

public:
 property System::Windows::ResourceDictionary ^ Resources { System::Windows::ResourceDictionary ^ get(); void set(System::Windows::ResourceDictionary ^ value); };

[System.Windows.Markup.Ambient]
public System.Windows.ResourceDictionary Resources { get; set; }

[<System.Windows.Markup.Ambient>]
member this.Resources : System.Windows.ResourceDictionary with get, set

Public Property Resources As ResourceDictionary

Valeur de propriété

ResourceDictionary

Dictionnaire de ressources actif défini localement, où chaque ressource est accessible par clé.

Attributs

AmbientAttribute

Remarques

Les dictionnaires de ressources qui peuvent être définis entièrement ou partiellement en XAML (Extensible Application Markup Language) sont généralement créés en tant qu’élément de propriété et se trouvent généralement sur l’élément racine pour n’importe quelle page individuelle ou pour l’application. Le fait de placer le dictionnaire de ressources à ce niveau facilite la recherche à partir 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 de définir les styles en tant qu’éléments d’objet dans un dictionnaire de ressources ou en tant que ressources externes afin que la ressource de style entière puisse être autonome (cette approche permet de séparer les responsabilités du concepteur et les responsabilités des développeurs 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 du processus de recherche de ressources réel, où un élément enfant peut accéder à l’une des ressources définies dans chaque élément parent, en effectuant une recherche récursive vers le haut.

Les ressources peuvent également être référencées par le code à partir de la collection, mais sachez que les ressources créées en XAML ne seront certainement pas accessibles tant qu’après Loaded avoir été levées par l’élément qui déclare le dictionnaire. En fait, les ressources sont analysées de manière asynchrone et même l’événement Loaded n’est pas une garantie que vous pouvez référencer une ressource définie par XAML. Pour cette raison, vous devez généralement accéder uniquement aux ressources DÉFINIES PAR XAML dans le cadre du code d’exécution, ou par le biais d’autres techniques XAML telles que des styles ou des références d’extension de ressource pour les valeurs d’attribut. Lorsque vous accédez à des ressources via du code, cela équivaut essentiellement à une référence DynamicResource faite à partir de XAML.

Le sous-jacent ResourceDictionary prend en charge les méthodes nécessaires pour ajouter, supprimer ou interroger des ressources au sein de la collection à l’aide de code. La Resources propriété est paramétrable pour prendre en charge le scénario de remplacement complet de la collection de ressources d’un élément en tant que nouveau ou différent ResourceDictionary.

Notez que la syntaxe XAML affichée n’inclut pas d’élément pour .ResourceDictionary Il s’agit d’un exemple de syntaxe de collection implicite ; une balise représentant l’élément de collection peut être omise. Les éléments ajoutés en tant qu’é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 toujours spécifié explicitement en tant qu’é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.

Utilisation des éléments de propriété XAML

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

Valeurs XAML

oneOrMoreResourceElements
Un ou plusieurs éléments d’objet, chacun d’eux définissant une ressource. Chaque élément de propriété de ressource au sein de chacun ResourceDictionary doit avoir une valeur unique pour la directive x:Key, qui sert de clé unique lorsque des valeurs sont récupérées à partir de ResourceDictionary.

Voir aussi

• Resources
• x:Key Attribute