FrameworkElement.Resources Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de lokaal gedefinieerde resourcewoordenlijst op of stelt u deze in.
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, setPublic Property Resources As ResourceDictionaryWaarde van eigenschap
De huidige lokaal gedefinieerde woordenlijst van resources, waar elke resource toegankelijk is via de sleutel.
- Kenmerken
Opmerkingen
Resourcewoordenlijsten die volledig of gedeeltelijk in Extensible Application Markup Language (XAML) kunnen worden gedefinieerd, worden meestal gemaakt als een eigenschapselement en bevinden zich meestal op het hoofdelement voor elke afzonderlijke pagina of voor de toepassing. Door de resourcewoordenlijst op dit niveau te plaatsen, is het gemakkelijker om afzonderlijke onderliggende elementen op de pagina (of vanaf een willekeurige pagina, in het toepassingsscenario) te vinden. In de meeste toepassingsscenario's raden we u aan om stijlen te definiëren als objectelementen in een resourcewoordenlijst of als externe resources te definiëren, zodat de hele stijlresource zelfstandig kan zijn (deze benadering helpt bij het scheiden van ontwerpverantwoordelijkheden van ontwikkelaars door de fysieke bestanden te scheiden die moeten worden bewerkt).
Houd er rekening mee dat deze eigenschap alleen de resourcewoordenlijst retourneert die rechtstreeks in dat element is gedeclareerd. Dit verschilt van het werkelijke opzoekproces voor resources, waarbij een onderliggend element toegang heeft tot alle resources die in elk bovenliggend element zijn gedefinieerd, waarbij recursief naar boven wordt gezocht.
Er kan ook naar resources worden verwezen door code vanuit de verzameling, maar houd er rekening mee dat resources die zijn gemaakt in XAML zeker niet toegankelijk zijn totdat het Loaded element dat de woordenlijst declareert, wordt gegenereerd. Resources worden zelfs asynchroon geparseerd en zelfs niet de Loaded gebeurtenis is een garantie dat u naar een door XAML gedefinieerde resource kunt verwijzen. Daarom moet u over het algemeen alleen toegang krijgen tot door XAML gedefinieerde resources als onderdeel van runtimecode, of via andere XAML-technieken, zoals stijlen of verwijzingen naar resource-extensies voor kenmerkwaarden. Wanneer u toegang krijgt tot resources via code, is deze in feite gelijk aan een DynamicResource-verwijzing van XAML.
De onderliggende ResourceDictionary methode ondersteunt de methoden die nodig zijn om resources toe te voegen, te verwijderen of op te vragen vanuit de verzameling met behulp van code. De Resources eigenschap is ingesteld ter ondersteuning van het scenario waarbij de resourcesverzameling van een element volledig wordt vervangen door een nieuw of ander ResourceDictionaryelement.
Zoals u ziet, bevat de weergegeven XAML-syntaxis geen element voor de ResourceDictionary. Dit is een voorbeeld van impliciete verzamelingssyntaxis; een tag die het verzamelingselement vertegenwoordigt, kan worden weggelaten. De elementen die als items aan de verzameling worden toegevoegd, worden in plaats daarvan opgegeven. Zie XAML-syntaxis in detail voor meer informatie over impliciete verzamelingen en XAML. Een geval waarin een element ResourceDictionary nog steeds expliciet als element wordt opgegeven, is als u een samengevoegde woordenlijst introduceert. In dat geval zijn er meestal geen onderliggende elementen voor.ResourceDictionary Zie Samengevoegde resourcewoordenlijsten voor meer informatie.
Gebruik van XAML-eigenschapselement
<object>
<object.Resources>
oneOrMoreResourceElements
</object.Resources>
</object>
XAML-waarden
oneOrMoreResourceElements Een of meer objectelementen, die elk een resource definiëren. Elk element van de resource-eigenschap binnen elk ResourceDictionary element moet een unieke waarde hebben voor de x:Sleutelrichtlijn, die fungeert als de unieke sleutel wanneer waarden worden opgehaald uit de ResourceDictionary.
