FrameworkElement.Resources Eigenschaft

Definition

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

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); };

[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

Eigenschaftswert

ResourceDictionary

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

Attribute

AmbientAttribute

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 in der Regel im Stammelement für jede einzelne Seite oder für die Anwendung. Wenn Sie das Ressourcenwörterbuch auf dieser Ebene platzieren, ist es einfacher, einzelne untergeordnete Elemente auf der Seite (oder im Anwendungsfall von einer beliebigen Seite) zu finden. In den meisten Anwendungsszenarien empfiehlt es sich, Stile als Objektelemente innerhalb eines Ressourcenwörterbuchs oder als externe Ressourcen zu definieren, damit die gesamte Stilressource eigenständig sein kann (dieser Ansatz hilft dabei, Die Verantwortlichkeiten des Designers von den Verantwortlichkeiten der Entwickler zu trennen, indem die physischen Dateien getrennt werden, die bearbeitet werden müssen).

Beachten Sie, dass diese Eigenschaft nur das Direkt in diesem Element deklarierte Ressourcenwörterbuch zurückgibt. Dies unterscheidet sich vom tatsächlichen Ressourcensucheprozess, bei dem ein untergeordnetes Element auf jede der in jedem übergeordneten Element definierten Ressourcen zugreifen kann und rekursiv nach oben sucht.

Auf Ressourcen kann auch durch Code innerhalb der Auflistung verwiesen werden. Beachten Sie jedoch, dass auf in XAML erstellte Ressourcen definitiv erst zugegriffen werden kann, wenn Loaded das Element, das das Wörterbuch deklariert, ausgelöst wird. Tatsächlich werden Ressourcen asynchron analysiert, und nicht einmal das Loaded Ereignis ist eine Garantie, dass Sie auf eine XAML-definierte Ressource verweisen können. Aus diesem Grund sollten Sie im Allgemeinen nur auf XAML-definierte Ressourcen als Teil von Laufzeitcode oder über andere XAML-Techniken wie Formatvorlagen oder Ressourcenerweiterungsverweise für Attributwerte zugreifen. Wenn Sie über Code auf Ressourcen zugreifen, entspricht dies im Wesentlichen einem DynamicResource-Verweis aus XAML.

Das zugrunde liegende ResourceDictionary 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 so festgelegt, dass sie das Szenario des vollständigen Ersetzens der Ressourcenauflistung eines Elements durch ein neues oder anderes ResourceDictionaryelement unterstützt.

Beachten Sie, dass die angezeigte XAML-Syntax kein Element für enthält ResourceDictionary. Dies ist ein Beispiel für implizite Sammlungssyntax. ein Tag, der das Auflistungselement darstellt, kann weggelassen werden. Stattdessen werden die Elemente angegeben, die der Auflistung als Elemente hinzugefügt werden. Weitere Informationen zu impliziten Sammlungen und XAML finden Sie unter XAML-Syntax im Detail. Ein Fall, in dem ein ResourceDictionary immer noch explizit als Element angegeben wird, ist, wenn Sie ein zusammengeführtes Wörterbuch einführen. In diesem Fall gibt es normalerweise keine untergeordneten Elemente für dieses 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, von denen jedes eine Ressource definiert. Jedes Ressourceneigenschaftenelement in jedem ResourceDictionary muss über einen eindeutigen Wert für die x:Key-Direktive verfügen, die als eindeutiger Schlüssel dient, wenn Werte aus dem ResourceDictionaryabgerufen werden.

Weitere Informationen

• Resources
• x:Key-Attribut