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 les composants et par 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 ne sont pas traités immédiatement lorsque le code d’application ResourceDictionary est chargé par un chargeur XAML. Au lieu de cela, le ResourceDictionary conserve 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 IDictionary mais s’appuie sur un Hashtable en 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 Syntaxe XAML en détail. Une exception est lorsque 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) sous forme de fichier de ressource ou de fichier libre. Dans ce cas, ResourceDictionary peut être déclaré en tant qu’élément objet, servant d’élément racine du 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) à 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 des collections implicites XAML

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

Valeurs XAML

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

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

Constructeurs

ResourceDictionary()

Initialise une nouvelle instance de la classe ResourceDictionary.

Propriétés

Count	Place le nombre d'entrées dans le ResourceDictionary de base.
DeferrableContent	Obtient ou définit le contenu à reporter pour ce dictionnaire de ressources.
InvalidatesImplicitDataTemplateResources	Obtient ou définit une valeur qui indique si les invalidations déclenchées par l’objet ResourceDictionary font en sorte que les objets ContentPresenter réévaluent leur choix de modèle. Les invalidations se produisent quand une ressource de modèle de données implicite change.
IsFixedSize	Obtient si ce ResourceDictionary est de taille fixe.
IsReadOnly	Obtient si ce 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 dictionnaires ResourceDictionary 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 les ressources.
Values	Obtient une collection de toutes les valeurs associée aux clés contenues dans ce ResourceDictionary.

Méthodes

Add(Object, Object)	Ajoute une ressource par clé à ce ResourceDictionary.
BeginInit()	Commence la phase d'initialisation pour ce ResourceDictionary.
Clear()	Efface toutes les clés (et valeurs) dans le ResourceDictionary de base. Cela n'efface aucun élément de dictionnaire fusionné.
Contains(Object)	Détermine si ResourceDictionary contient un élément avec la clé spécifiée.
CopyTo(DictionaryEntry[], Int32)	Copie les entrées des éléments ResourceDictionary dans un DictionaryEntry à une dimension à l'index spécifié.
EndInit()	Termine la phase d'initialisation et invalide l'arborescence précédente afin de tenir compte de toutes les modifications effectuées sur les clés pendant la phase d'initialisation.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
FindName(String)	Non pris en charge par cette implémentation de dictionnaire.
GetEnumerator()	Retourne un IDictionaryEnumerator pouvant être utilisé pour itérer au sein du ResourceDictionary.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
OnGettingValue(Object, Object, Boolean)	Se produit lorsque le ResourceDictionary reçoit une demande pour une ressource.
RegisterName(String, Object)	Non pris en charge par cette implémentation de dictionnaire.
Remove(Object)	Supprime du dictionnaire de base l'entrée avec la clé spécifiée.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)
UnregisterName(String)	Non pris en charge par cette implémentation de dictionnaire.

Implémentations d’interfaces explicites

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.

Méthodes d’extension

Voir aussi

• Resources
• Resources