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

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

Valeur de propriété

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.

Remarques

Les dictionnaires de ressources qui peuvent être définis complètement ou partiellement en langage XAML (eXtensible Application Markup Language)Extensible Application Markup Language (XAML) sont généralement créés comme élément de propriété et sont généralement sur l’élément racine pour n’importe quelle page individuel ou pour l’application.Resource dictionaries that can be defined completely or partially in langage XAML (eXtensible Application Markup Language)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. 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 d’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 être définis en tant qu’éléments objet dans un dictionnaire de ressources, ou être définis comme des ressources externes afin que la ressource de style entière peut être autonome (cette approche permet de concepteur distinct responsabilités du développeur en séparant les fichiers physiques qui doivent être modifiées).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 de celui du processus de recherche de ressource réelle, où un élément enfant peut accéder à toutes les ressources définies dans chaque élément parent, la recherche de manière récursive vers le haut.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.

Peut également être référencées par le code à partir de la collection de ressources, mais n’oubliez pas que les ressources créées dans XAMLXAML sans aucun doute ne seront plus accessibles jusqu’après Loaded est 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 XAMLXAML 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 façon asynchrone et pas même le Loaded événement est l’assurance que vous pouvez référencer un XAMLXAML défini de ressources.In fact, resources are parsed asynchronously and not even the Loaded event is an assurance that you can reference a XAMLXAML defined resource. C’est pourquoi vous devez généralement accéder uniquement aux XAMLXAML définies des ressources dans le cadre du code au moment de l’exécution, ou par le biais des autres XAMLXAML techniques 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 XAMLXAML defined resources as part of run-time code, or through other XAMLXAML techniques such as styles or resource extension references for attribute values. Lorsque vous accédez aux ressources via le code, il est fondamentalement équivalent à un DynamicResource référence effectuée depuis XAMLXAML.When you access resources through code, it is essentially equivalent to a DynamicResource reference made from XAMLXAML.

Sous-jacent ResourceDictionary prend en charge les méthodes requises pour ajouter, supprimer ou interroger les 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. Le Resources propriété peut être définie pour prendre en charge le scénario du remplacement complet de la collection de ressources d’un élément à 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 le XAMLXAML syntaxe indiquée n’inclut pas un élément pour le ResourceDictionary.Notice that the XAMLXAML syntax shown does not include an element for the ResourceDictionary. Il s’agit d’un exemple de syntaxe de collection implicite ; une balise qui représente 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 XAMLXAML, consultez syntaxe de XAML en détail.For more information about implicit collections and XAMLXAML, see XAML Syntax In Detail. Un cas où un ResourceDictionary est encore spécifié explicitement comme un élément est si vous introduisez un dictionnaire fusionné, auquel cas il n’existe généralement aucun élément enfant pour qui 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éfinit une ressource.One or more object elements, each of which defines a resource. Chaque élément de propriété de ressource au sein de chaque ResourceDictionary doit avoir une valeur unique pour le Directive x : Key, qui sert de clé unique lorsque les valeurs sont récupérées à partir de la 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