FrameworkElement.Resources FrameworkElement.Resources FrameworkElement.Resources FrameworkElement.Resources Property

Definition

Ruft das lokal definierte Ressourcenwörterbuch ab oder legt es fest.Gets or sets the locally-defined resource dictionary.

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; }
member this.Resources : System.Windows.ResourceDictionary with get, set
Public Property Resources As ResourceDictionary

Eigenschaftswert

Das derzeit lokal definierte Ressourcenwörterbuch, in dem mit einem Schlüssel auf jede Ressource zugegriffen werden kann.The current locally-defined dictionary of resources, where each resource can be accessed by key.

Hinweise

Ressourcenverzeichnisse, die vollständig oder teilweise in definiert werden können Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) werden in der Regel als ein Property-Element erstellt und sind in der Regel für das Stammelement für die einzelnen Seiten oder für die Anwendung.Resource dictionaries that can be defined completely or partially in Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) are typically created as a property element, and are typically on the root element for any individual page or for the application. Platzieren das Ressourcenverzeichnis auf dieser Ebene erleichtert die von einzelnen untergeordneten Elemente auf der Seite (oder von einer beliebigen Seite, bei der Anwendung) zu suchen.Placing the resource dictionary at this level makes it easier to find from individual child elements in the page (or from any page, in the application case). In den meisten Anwendungsszenarien, wird empfohlen, Stile, die als Object-Elemente in einem Ressourcenverzeichnis definiert werden oder als externe Ressourcen definiert werden, damit die gesamte Stilressource eigenständig sein kann (Dadurch werden separate-Designer Zuständigkeiten von Entwickleraufgaben durch die Trennung der physischen Dateien, die bearbeitet werden müssen).In most application scenarios, we recommend that styles be defined as object elements within a resource dictionary, or be defined as external resources so that the entire style resource can be self-contained (this approach helps separate designer responsibilities from developer responsibilities by separating the physical files that need to be edited).

Beachten Sie, dass diese Eigenschaft gibt nur das Ressourcenverzeichnis direkt innerhalb dieses Elements deklariert.Note that this property returns only the resource dictionary declared directly within that element. Dies ist anders als die eigentliche Ressource Lookup-Prozess, in dem ein untergeordnetes Element eines in jedem übergeordneten Element, die Suche rekursiv aufwärts definierten Ressourcen zugreifen können.This is different than the actual resource lookup process, where a child element can access any of the resources defined in each parent element, searching recursively upwards.

Ressourcen können auch Code aus der Auflistung verwiesen werden, aber beachten Sie, dass Ressourcen in erstellt XAMLXAML wird definitiv nicht zugegriffen werden erst nach dem Loaded wird ausgelöst, durch das Element, das das Wörterbuch deklariert.Resources can also be referenced by code from within the collection, but be aware that resources created in XAMLXAML will definitely not be accessible until after Loaded is raised by the element that declares the dictionary. Ressourcen werden in der Tat analysiert, asynchron und nicht selbst die Loaded Ereignis ist eine Zusicherung, die Sie verweisen können eine XAMLXAML Ressource definiert.In fact, resources are parsed asynchronously and not even the Loaded event is an assurance that you can reference a XAMLXAML defined resource. Aus diesem Grund sollten Sie in der Regel nur auf zugreifen XAMLXAML sich systemdefinierte Ressourcen als Teil der Laufzeitcode oder über andere XAMLXAML Techniken wie z. B. Stile oder ressourcenerweiterungsparameter für Attributwerte.For this reason you should generally only access XAMLXAML defined resources as part of run-time code, or through other XAMLXAML techniques such as styles or resource extension references for attribute values. Wenn Sie über Code auf Ressourcen zugreifen, dies entspricht im Wesentlichen eine DynamicResource -Verweis in XAMLXAML.When you access resources through code, it is essentially equivalent to a DynamicResource reference made from XAMLXAML.

Die zugrunde liegende ResourceDictionary unterstützt die Methoden zum Hinzufügen, entfernen oder Abfragen von Ressourcen in der Auflistung mithilfe von Code erforderlich.The underlying ResourceDictionary supports the methods required to add, remove or query resources from within the collection by using code. Die Resources Eigenschaft kann festgelegt werden, um die Unterstützung des Szenarios vollständig ersetzen die ressourcenauflistung der Elemente in ein neues oder anderes sein ResourceDictionary.The Resources property is settable to support the scenario of completely replacing the resources collection of an element to be a new or different ResourceDictionary.

Beachten Sie, dass die XAMLXAML gezeigte Syntax enthält kein Element für die ResourceDictionary.Notice that the XAMLXAML syntax shown does not include an element for the ResourceDictionary. Dies ist ein Beispiel für die implizite Auflistungssyntax; Ein Tag, das das Auflistungselement darstellt, kann ausgelassen werden.This is an example of implicit collection syntax; a tag representing the collection element can be omitted. Die Elemente, die als Elemente der Auflistung hinzugefügt werden, werden stattdessen angegeben.The elements that are added as items to the collection are specified instead. Weitere Informationen zu impliziten Sammlungen und XAMLXAML, finden Sie unter XAML-Syntax im Detail.For more information about implicit collections and XAMLXAML, see XAML Syntax In Detail. Ein Fall, in denen eine ResourceDictionary wird immer noch explizit angegeben, wie ein Element ist, wenn Sie ein zusammengeführtes Wörterbuch vorgestellt werden, in diesem Fall stehen in der Regel keine untergeordneten Elemente für diesen ResourceDictionary.One case where a ResourceDictionary is still specified explicitly as an element is if you are introducing a merged dictionary, in which case there are typically no child elements for that ResourceDictionary. Weitere Informationen finden Sie unter zusammengeführte Ressourcenverzeichnisse.For details, see Merged Resource Dictionaries.

Verwendung von XAML-EigenschaftenelementenXAML Property Element Usage

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

XAML-WerteXAML Values

oneOrMoreResourceElementsoneOrMoreResourceElements
Eine oder mehrere Object-Elemente, die jeweils eine Ressource definieren.One or more object elements, each of which defines a resource. Jede Ressource Property-Element innerhalb der einzelnen ResourceDictionary müssen einen eindeutigen Wert für die X: Key Directive, der dient als eindeutige Schlüssel beim Abrufen von Werten aus der ResourceDictionary.Each resource property element within each ResourceDictionary must have a unique value for the x:Key Directive, which serves as the unique key when values are retrieved from the ResourceDictionary.

Gilt für:

Siehe auch