FrameworkElement.Resources Eigenschaft

Definition

Ruft das lokal definierte Ressourcenwörterbuch ab oder legt es fest.

public:
 property System::Windows::ResourceDictionary ^ Resources { System::Windows::ResourceDictionary ^ get(); void set(System::Windows::ResourceDictionary ^ value); };
public System.Windows.ResourceDictionary Resources { get; set; }
[System.Windows.Markup.Ambient]
public System.Windows.ResourceDictionary Resources { get; set; }
member this.Resources : System.Windows.ResourceDictionary with get, set
[<System.Windows.Markup.Ambient>]
member this.Resources : System.Windows.ResourceDictionary with get, set
Public Property Resources As ResourceDictionary

Eigenschaftswert

ResourceDictionary

Das derzeit lokal definierte Ressourcenwörterbuch, in dem mit einem Schlüssel auf jede Ressource zugegriffen werden kann.

Attribute

Hinweise

Ressourcenwörterbücher, die vollständig oder teilweise in Extensible Application Markup Language (XAML) definiert werden können, werden in der Regel als Eigenschaftselement erstellt und befinden sich normalerweise auf dem Stammelement für jede einzelne Seite oder für die Anwendung. Das Platzieren des Ressourcenwörterbuchs auf dieser Ebene erleichtert die Suche von einzelnen untergeordneten Elementen auf der Seite (oder von einer beliebigen Seite im Anwendungsfall). In den meisten Anwendungsszenarien empfiehlt es sich, Formatvorlagen als Objektelemente in einem Ressourcenwörterbuch zu definieren oder als externe Ressourcen zu definieren, damit die gesamte Formatvorlage selbst enthalten sein kann (dieser Ansatz hilft, Designeraufgaben von Entwickleraufgaben zu trennen, indem die physischen Dateien getrennt werden müssen, die bearbeitet werden müssen).

Beachten Sie, dass diese Eigenschaft nur das Ressourcenwörterbuch zurückgibt, das direkt innerhalb dieses Elements deklariert ist. Dies unterscheidet sich von dem tatsächlichen Nachschlagevorgang der Ressource, bei dem ein untergeordnetes Element auf eine der ressourcen zugreifen kann, die in jedem übergeordneten Element definiert sind und rekursiv nach oben suchen.

Ressourcen können auch von Code aus der Auflistung verwiesen werden, aber beachten Sie, dass ressourcen, die in XAML erstellt wurden, definitiv erst zugänglich Loaded sein, nachdem das Element ausgelöst wurde, das das Wörterbuch deklariert. Tatsächlich werden Ressourcen asynchron analysiert und nicht einmal das Loaded Ereignis ist eine Zusicherung, dass Sie auf eine definierte XAML-Ressource verweisen können. Aus diesem Grund sollten Sie in der Regel nur auf XAML definierte Ressourcen als Teil des Laufzeitcodes oder über andere XAML-Techniken wie Formatvorlagen oder Ressourcenerweiterungsbezüge für Attributwerte zugreifen. Wenn Sie über Code auf Ressourcen zugreifen, entspricht es im Wesentlichen einem DynamicResource-Verweis aus XAML.

Der zugrunde ResourceDictionary liegende Unterstützt die Methoden, die zum Hinzufügen, Entfernen oder Abfragen von Ressourcen innerhalb der Auflistung mithilfe von Code erforderlich sind. Die Resources Eigenschaft ist festgelegt, um das Szenario zu unterstützen, dass die Ressourcensammlung eines Elements vollständig ersetzt wird, um ein neues oder anderes ResourceDictionaryzu sein.

Beachten Sie, dass die angezeigte XAML-Syntax kein Element für das ResourceDictionary. Dies ist ein Beispiel für implizite Auflistungssyntax; ein Tag, der das Auflistungselement darstellt, kann ausgelassen werden. Die Elemente, die als Elemente zur Auflistung hinzugefügt werden, werden stattdessen angegeben. Weitere Informationen zu impliziten Sammlungen und XAML finden Sie im Detail unter XAML-Syntax. Ein Fall, in dem ein ResourceDictionary Element noch explizit als Element angegeben wird, wenn Sie ein zusammengeführtes Wörterbuch einführen, in diesem Fall gibt es in der Regel keine untergeordneten Elemente dafür ResourceDictionary. Ausführliche Informationen finden Sie unter "Zusammengeführte Ressourcenwörterbücher".

Verwendung von XAML-Eigenschaftenelementen

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

XAML-Werte

oneOrMoreResourceElements
Ein oder mehrere Objektelemente, die jeweils eine Ressource definieren. Jedes Ressourceneigenschaftselement innerhalb jeder ResourceDictionary muss einen eindeutigen Wert für die x:Key-Richtlinie aufweisen, die als eindeutiger Schlüssel dient, wenn Werte aus dem ResourceDictionaryWert abgerufen werden.

Gilt für:

Siehe auch