ResourceDictionary Classe

Définition

Espace de noms:

System.Windows

Assembly:

PresentationFramework.dll

Fournit une implémentation de table de hachage/dictionnaire qui contient des ressources WPF utilisées par des composants et d’autres éléments d’une application WPF.

public ref class ResourceDictionary : System::Collections::IDictionary, System::ComponentModel::ISupportInitialize, System::Windows::Markup::INameScope, System::Windows::Markup::IUriContext

[System.Windows.Localizability(System.Windows.LocalizationCategory.Ignore)]
[System.Windows.Markup.Ambient]
[System.Windows.Markup.UsableDuringInitialization(true)]
public class ResourceDictionary : System.Collections.IDictionary, System.ComponentModel.ISupportInitialize, System.Windows.Markup.INameScope, System.Windows.Markup.IUriContext

[<System.Windows.Localizability(System.Windows.LocalizationCategory.Ignore)>]
[<System.Windows.Markup.Ambient>]
[<System.Windows.Markup.UsableDuringInitialization(true)>]
type ResourceDictionary = class
    interface ICollection
    interface IEnumerable
    interface IDictionary
    interface ISupportInitialize
    interface INameScope
    interface IUriContext

Public Class ResourceDictionary
Implements IDictionary, INameScope, ISupportInitialize, IUriContext

Héritage

Object

ResourceDictionary

Dérivé

System.Activities.Core.Presentation.Themes.DesignerStylesDictionary

Attributs

LocalizabilityAttribute AmbientAttribute UsableDuringInitializationAttribute

Implémente

ICollection IDictionary IEnumerable ISupportInitialize INameScope IUriContext

Remarques

Les éléments d’un élément ResourceDictionary ne sont pas immédiatement traités lorsque le code d’application est chargé par un chargeur XAML. Au lieu de cela, les ResourceDictionary éléments persistants en tant qu’objet et les valeurs individuelles sont traitées uniquement lorsqu’elles sont spécifiquement demandées.

La ResourceDictionary classe n’est pas dérivée de DictionaryBase. Au lieu de cela, la ResourceDictionary classe implémente, mais s’appuie sur un Hashtable élément IDictionary interne.

Dans XAML (Extensible Application Markup Language), la ResourceDictionary classe est généralement un élément de collection implicite qui est la valeur de l’élément objet de plusieurs Resources propriétés, lorsqu’elle est donnée dans la syntaxe de l’élément de propriété. Pour plus d’informations sur les collections implicites en XAML, consultez la syntaxe XAML en détail. Une exception est quand vous souhaitez spécifier un dictionnaire fusionné ; pour plus d’informations, consultez Dictionnaires de ressources fusionnés.

Une autre utilisation xaml possible consiste à déclarer un dictionnaire de ressources en tant que fichier XAML discret, et à le charger au moment de l’exécution avec Load ou à l’inclure dans un projet (confiance totale) en tant que ressource ou fichier libre. Dans ce cas, ResourceDictionary peut être déclaré en tant qu’élément objet, servant d’élément racine du code XAML. Vous devez mapper les valeurs d’espace de noms XML appropriées (par défaut pour l’espace de noms WPF et généralement x: pour l’espace de noms XAML) sur l’élément ResourceDictionary si vous envisagez de l’utiliser comme élément racine. Vous pouvez ensuite ajouter des éléments enfants qui définissent les ressources, chacune avec une valeur x :Key .

Utilisation de la collection implicite XAML

<object>
  <object.resourcesProperty>
    oneOrMoreResources
  </object.resourcesProperty>
</object>

Valeurs XAML

resourcesProperty Propriété spécifiant un élément de propriété, où le type valeur de cette propriété est ResourceDictionary. En règle générale, il s’agit de la Resources propriété ou FrameworkElementFrameworkContentElement, ou d’un cas de ressources d’application Application .

oneOrMoreResources Une ou plusieurs ressources spécifiées en tant qu’éléments d’objet. Chaque ressource que vous spécifiez doit avoir une directive x :Key affectée.

Constructeurs

Nom	Description
ResourceDictionary()	Initialise une nouvelle instance de la classe ResourceDictionary.

Propriétés

Nom	Description
Count	Obtient le nombre d’entrées dans la base ResourceDictionary.
DeferrableContent	Obtient ou définit le contenu différé pour ce dictionnaire de ressources.
InvalidatesImplicitDataTemplateResources	Obtient ou définit une valeur qui indique si les invalidations déclenchées par l’objet ResourceDictionary entraînent ContentPresenter la réévaluation de leur choix de modèle. Les invalidations se produisent lorsqu’une ressource de modèle de données implicite change.
IsFixedSize	Obtient si cette ResourceDictionary taille est fixe.
IsReadOnly	Obtient si cela ResourceDictionary est en lecture seule.
Item[Object]	Obtient ou définit la valeur associée à la clé donnée.
Keys	Obtient une collection de toutes les clés contenues dans ce ResourceDictionary.
MergedDictionaries	Obtient une collection des ResourceDictionary dictionnaires qui constituent les différents dictionnaires de ressources dans les dictionnaires fusionnés.
Source	Obtient ou définit l’URI (Uniform Resource Identifier) à partir duquel charger des ressources.
Values	Obtient une collection de toutes les valeurs associées aux clés contenues dans ce ResourceDictionary.

Méthodes

Nom	Description
Add(Object, Object)	Ajoute une ressource par clé à ceci ResourceDictionary.
BeginInit()	Commence la phase d’initialisation pour ce ResourceDictionary.
Clear()	Efface toutes les clés (et valeurs) dans la base ResourceDictionary. Cela n’efface aucun élément de dictionnaire fusionné.
Contains(Object)	Détermine si le ResourceDictionary contient un élément avec la clé spécifiée.
CopyTo(DictionaryEntry[], Int32)	Copie les ResourceDictionary éléments dans une dimension DictionaryEntry à l’index spécifié.
EndInit()	Termine la phase d’initialisation et invalide l’arborescence précédente afin que toutes les modifications apportées aux clés pendant la phase d’initialisation puissent être prises en compte.
FindName(String)	Non pris en charge par cette implémentation dictionnaire.
GetEnumerator()	Retourne un IDictionaryEnumerator qui peut être utilisé pour itérer au sein du ResourceDictionary.
OnGettingValue(Object, Object, Boolean)	Se produit lorsque la ResourceDictionary requête reçoit une ressource.
RegisterName(String, Object)	Non pris en charge par cette implémentation dictionnaire.
Remove(Object)	Supprime l’entrée avec la clé spécifiée du dictionnaire de base.
UnregisterName(String)	Non pris en charge par cette implémentation dictionnaire.

Implémentations d’interfaces explicites

Nom	Description
ICollection.CopyTo(Array, Int32)	Pour obtenir une description de ce membre, consultez CopyTo(Array, Int32).
ICollection.IsSynchronized	Pour obtenir une description de ce membre, consultez IsSynchronized.
ICollection.SyncRoot	Pour obtenir une description de ce membre, consultez SyncRoot.
IEnumerable.GetEnumerator()	Pour obtenir une description de ce membre, consultez GetEnumerator().
IUriContext.BaseUri	Pour obtenir une description de ce membre, consultez BaseUri.

Voir aussi

• Resources
• Resources