ResourceDictionary Klasse

Definition

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Stellt eine Hashtabelle/Wörterbuchimplementierung bereit, die von Komponenten und anderen Elementen einer WPF-Anwendung verwendete WPF-Ressourcen enthält.

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

Vererbung

Object

ResourceDictionary

Abgeleitet

System.Activities.Core.Presentation.Themes.DesignerStylesDictionary

Attribute

LocalizabilityAttribute AmbientAttribute UsableDuringInitializationAttribute

Implementiert

ICollection IDictionary IEnumerable ISupportInitialize INameScope IUriContext

Hinweise

Die Elemente in einem ResourceDictionary werden nicht sofort verarbeitet, wenn Anwendungscode von einem XAML-Ladeprogramm geladen wird. Stattdessen wird das ResourceDictionary als -Objekt beibehalten, und die einzelnen Werte werden nur verarbeitet, wenn sie speziell angefordert werden.

Die ResourceDictionary -Klasse wird nicht von DictionaryBaseabgeleitet. Stattdessen implementiert IDictionary die ResourceDictionary Klasse, basiert jedoch auf einem Hashtable intern.

In Extensible Application Markup Language (XAML) ist die Klasse in der ResourceDictionary Regel ein implizites Auflistungselement, das der Objektelementwert mehrerer Resources Eigenschaften ist, wenn es in der Eigenschaftenelementsyntax angegeben wird. Ausführliche Informationen zu impliziten Sammlungen in XAML finden Sie unter XAML-Syntax im Detail. Eine Ausnahme ist, wenn Sie ein zusammengeführtes Wörterbuch angeben möchten. Weitere Informationen finden Sie unter Zusammengeführte Ressourcenwörterbücher.

Eine weitere mögliche XAML-Verwendung besteht darin, ein Ressourcenwörterbuch als separate XAML-Datei zu deklarieren und entweder zur Laufzeit mit Load zu laden oder es in ein (voll vertrauenswürdiges) Projekt als Ressource oder lose Datei einzuschließen. In diesem Fall ResourceDictionary kann als Objektelement deklariert werden, das als Stammelement des XAML dient. Sie müssen dem Element die entsprechenden XML-Namespacewerte (Standard für den WPF-Namespace und in der Regel x: für den ResourceDictionary XAML-Namespace) zuordnen, wenn Sie es als Stammelement verwenden möchten. Anschließend können Sie untergeordnete Elemente hinzufügen, die die Ressourcen definieren, jeweils mit einem x:Key-Wert .

Verwendung der impliziten XAML-Auflistung

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

XAML-Werte

resourcesProperty
Eine Eigenschaft, die ein Eigenschaftselement angibt, wobei der Werttyp dieser Eigenschaft ist ResourceDictionary. In der Regel ist dies die Resources Eigenschaft von FrameworkElement oder FrameworkContentElementoder Application in einem Anwendungsressourcenfall.

oneOrMoreResources
Mindestens eine Ressource, die als Objektelemente angegeben ist. Jeder ressource, die Sie angeben, muss eine x:Key-Direktive zugewiesen sein.

Konstruktoren

ResourceDictionary()

Initialisiert eine neue Instanz der ResourceDictionary-Klasse.

Eigenschaften

Count	Ruft die Anzahl der Einträge im Basis-ResourceDictionary ab.
DeferrableContent	Ruft den verzögerbaren Inhalt für dieses Ressourcenwörterbuch ab oder legt ihn fest.
InvalidatesImplicitDataTemplateResources	Ruft einen Wert ab oder legt ihn fest, der angibt, ob vom ResourceDictionary-Objekt ausgelöste Invalidierungen dazu führen, dass ContentPresenter-Objekte ihre Vorlagenwahl neu bewerten. Invalidierungen treten auf, wenn sich eine implizite Datenvorlagenressource ändert.
IsFixedSize	Ruft ab, ob dieses ResourceDictionary eine feste Größe hat.
IsReadOnly	Ruft ab, ob dieses ResourceDictionary schreibgeschützt ist.
Item[Object]	Ruft den Wert ab, der dem angegebenen Schlüssel zugeordnet ist, oder legt diesen fest.
Keys	Ruft eine Auflistung aller in diesem ResourceDictionary enthaltenen Schlüssel ab.
MergedDictionaries	Ruft eine Auflistung der ResourceDictionary-Wörterbücher ab, aus denen sich die verschiedenen Ressourcenwörterbücher in den zusammengeführten Wörterbüchern zusammensetzen.
Source	Ruft den URI (Uniform Resource Identifier) ab, aus dem Ressourcen geladen werden sollen, oder legt ihn fest.
Values	Ruft eine Auflistung aller Werte ab, die Schlüsseln zugeordnet sind, die in diesem ResourceDictionary enthalten sind.

Methoden

Add(Object, Object)	Fügt diesem ResourceDictionary eine Ressource nach Schlüssel hinzu.
BeginInit()	Beginnt die Initialisierung für dieses ResourceDictionary.
Clear()	Löscht alle Schlüssel (und Werte) im Basis-ResourceDictionary. Zusammengeführte Wörterbuchelemente werden dabei nicht gelöscht.
Contains(Object)	Ermittelt, ob das ResourceDictionary ein Element mit dem angegebenen Schlüssel enthält.
CopyTo(DictionaryEntry[], Int32)	Kopiert die ResourceDictionary-Elemente am angegebenen Index in ein eindimensionales DictionaryEntry.
EndInit()	Beendet die Initialisierung und macht die vorherige Struktur ungültig, sodass alle Änderungen, die während der Initialisierung an den Schlüsseln vorgenommen wurden, erfasst werden.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
FindName(String)	Wird von dieser Wörterbuchimplementierung nicht unterstützt.
GetEnumerator()	Gibt einen IDictionaryEnumerator zurück, der zum Durchlaufen des ResourceDictionary verwendet werden kann.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnGettingValue(Object, Object, Boolean)	Tritt auf, wenn das ResourceDictionary eine Ressourcenanforderung empfängt.
RegisterName(String, Object)	Wird von dieser Wörterbuchimplementierung nicht unterstützt.
Remove(Object)	Entfernt den Eintrag mit dem angegebenen Schlüssel aus dem Basiswörterbuch.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
UnregisterName(String)	Wird von dieser Wörterbuchimplementierung nicht unterstützt.

Explizite Schnittstellenimplementierungen

ICollection.CopyTo(Array, Int32)	Eine Beschreibung dieses Elements finden Sie unter CopyTo(Array, Int32).
ICollection.IsSynchronized	Eine Beschreibung dieses Elements finden Sie unter IsSynchronized.
ICollection.SyncRoot	Eine Beschreibung dieses Elements finden Sie unter SyncRoot.
IEnumerable.GetEnumerator()	Eine Beschreibung dieses Elements finden Sie unter GetEnumerator().
IUriContext.BaseUri	Eine Beschreibung dieses Elements finden Sie unter BaseUri.

Erweiterungsmethoden

Weitere Informationen

• Resources
• Resources