FrameworkElement.Resources Propriété

Définition

Obtient ou définit le dictionnaire de ressources défini localement.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; }
public System.Windows.ResourceDictionary Resources { get; set; }
[<System.Windows.Markup.Ambient>]
member this.Resources : System.Windows.ResourceDictionary with get, set
member this.Resources : System.Windows.ResourceDictionary with get, set
Public Property Resources As ResourceDictionary

Valeur de propriété

ResourceDictionary

Dictionnaire de ressources actif défini localement, où chaque ressource est accessible par clé.The current locally-defined dictionary of resources, where each resource can be accessed by key.

Attributs

Remarques

Les dictionnaires de ressources qui peuvent être définis entièrement ou partiellement en Extensible Application Markup Language (XAML) sont généralement créés en tant qu’élément de propriété et se trouvent généralement sur l’élément racine pour une page individuelle ou pour l’application.Resource dictionaries that can be defined completely or partially in 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. Le fait de placer le dictionnaire de ressources à ce niveau facilite la recherche d’éléments enfants individuels dans la page (ou à partir de n’importe quelle page, dans le cas de l’application).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). Dans la plupart des scénarios d’application, nous recommandons que les styles soient définis en tant qu’éléments objet dans un dictionnaire de ressources, ou soient définis comme des ressources externes afin que la ressource de style entière puisse être autonome (cette approche permet de séparer les responsabilités du développeur en séparant les fichiers physiques qui doivent être modifiés).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).

Notez que cette propriété retourne uniquement le dictionnaire de ressources déclaré directement dans cet élément.Note that this property returns only the resource dictionary declared directly within that element. Cela est différent du processus réel de recherche de ressources, où un élément enfant peut accéder à toutes les ressources définies dans chaque élément parent, en effectuant une recherche de manière récursive.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.

Les ressources peuvent également être référencées par du code à partir de la collection, mais sachez que les ressources créées en XAML ne seront absolument pas accessibles tant que Loaded l’élément n’aura pas été déclenché par l’élément qui déclare le dictionnaire.Resources can also be referenced by code from within the collection, but be aware that resources created in XAML will definitely not be accessible until after Loaded is raised by the element that declares the dictionary. En fait, les ressources sont analysées de manière asynchrone, et même l' Loaded événement est une assurance que vous pouvez référencer une ressource définie par XAML.In fact, resources are parsed asynchronously and not even the Loaded event is an assurance that you can reference a XAML defined resource. Pour cette raison, vous devez généralement accéder uniquement aux ressources définies par XAML dans le cadre du code d’exécution, ou par le biais d’autres techniques XAML telles que les styles ou les références d’extension de ressource pour les valeurs d’attribut.For this reason you should generally only access XAML defined resources as part of run-time code, or through other XAML techniques such as styles or resource extension references for attribute values. Lorsque vous accédez à des ressources par le biais du code, il est essentiellement équivalent à une référence DynamicResource créée à partir de XAML.When you access resources through code, it is essentially equivalent to a DynamicResource reference made from XAML.

Le sous-jacent ResourceDictionary prend en charge les méthodes requises pour ajouter, supprimer ou interroger des ressources à partir de la collection à l’aide de code.The underlying ResourceDictionary supports the methods required to add, remove or query resources from within the collection by using code. La Resources propriété peut être définie de façon à prendre en charge le scénario de remplacement complet de la collection de ressources d’un élément comme étant nouveau ou différent 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.

Notez que la syntaxe XAML indiquée n’inclut pas d’élément pour ResourceDictionary .Notice that the XAML syntax shown does not include an element for the ResourceDictionary. Il s’agit d’un exemple de syntaxe de collection implicite. une balise représentant l’élément de collection peut être omise.This is an example of implicit collection syntax; a tag representing the collection element can be omitted. Les éléments qui sont ajoutés en tant qu’éléments à la collection sont spécifiés à la place.The elements that are added as items to the collection are specified instead. Pour plus d’informations sur les collections implicites et XAML, consultez syntaxe XAML en détail.For more information about implicit collections and XAML, see XAML Syntax In Detail. Un cas où un ResourceDictionary est toujours spécifié explicitement comme un élément est si vous introduisez un dictionnaire fusionné, auquel cas il n’y a généralement pas d’éléments enfants pour cela 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. Pour plus d’informations, consultez dictionnaires de ressources fusionnés.For details, see Merged Resource Dictionaries.

Utilisation des éléments de propriété XAMLXAML Property Element Usage

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

Valeurs XAMLXAML Values

oneOrMoreResourceElementsoneOrMoreResourceElements
Un ou plusieurs éléments objet, chacun d’eux définissant une ressource.One or more object elements, each of which defines a resource. Chaque élément de propriété de ressource dans chaque ResourceDictionary doit avoir une valeur unique pour la directive x :Key, qui sert de clé unique lorsque les valeurs sont récupérées à partir de 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.

S’applique à

Voir aussi