FrameworkElement.Resources Vlastnost

Definice

Získá nebo nastaví místně definovaný slovník prostředků.

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, set
Public Property Resources As ResourceDictionary

Hodnota vlastnosti

ResourceDictionary

Aktuální místně definovaný slovník prostředků, ke které má každý prostředek přístup pomocí klíče.

Atributy

Poznámky

Slovníky prostředků, které mohou být definovány zcela nebo částečně v Extensible Application Markup Language (XAML) jsou obvykle vytvořeny jako element vlastnosti a jsou obvykle na kořenovém prvku pro každou jednotlivou stránku nebo pro aplikaci. Umístění slovníku prostředků na tuto úroveň usnadňuje vyhledání jednotlivých podřízených prvků na stránce (nebo z jakékoli stránky v případě aplikace). Ve většině aplikačních scénářů doporučujeme definovat styly jako prvky objektů ve slovníku prostředků nebo je definovat jako externí prostředky, aby celý prostředek stylu mohl být samostatný (tento přístup pomáhá oddělit odpovědnost návrháře od povinností vývojáře oddělením fyzických souborů, které je potřeba upravit).

Všimněte si, že tato vlastnost vrací pouze slovník prostředků deklarovaný přímo v tomto prvku. To se liší od skutečného procesu vyhledávání prostředků, kdy podřízený prvek může přistupovat ke všem prostředkům definovaným v jednotlivých nadřazených elementech a prohledávat rekurzivně směrem nahoru.

Prostředky mohou být také odkazovány kódem z kolekce, ale mějte na paměti, že prostředky vytvořené v XAML nebudou přístupné až po Loaded vyvolání elementem, který deklaruje slovník. Prostředky se ve skutečnosti analyzují asynchronně, a dokonce ani Loaded událost je zárukou, že můžete odkazovat na definovaný prostředek XAML. Z tohoto důvodu byste měli obecně přistupovat k definovaným prostředkům XAML pouze jako součást kódu za běhu nebo prostřednictvím jiných technik XAML, jako jsou styly nebo odkazy na rozšíření prostředků pro hodnoty atributů. Když přistupujete k prostředkům prostřednictvím kódu, je v podstatě ekvivalentní odkazu DynamicResource vytvořenému z XAML.

Podklad ResourceDictionary podporuje metody potřebné k přidání, odebrání nebo dotazování prostředků z kolekce pomocí kódu. Vlastnost Resources je nastavena tak, aby podporovala scénář úplné nahrazení kolekce prostředků prvku na novou nebo jinou ResourceDictionary.

Všimněte si, že zobrazená syntaxe XAML neobsahuje prvek pro ResourceDictionary. Toto je příklad implicitní syntaxe kolekce; značku představující prvek kolekce je možné vynechat. Prvky přidané jako položky do kolekce jsou místo toho zadány. Další informace o implicitních kolekcích a XAML najdete v tématu Syntaxe XAML podrobně. Jedním z případů, kdy ResourceDictionary je stále zadán explicitně jako prvek je, pokud zavádíte sloučený slovník, v takovém případě neexistují obvykle žádné podřízené prvky pro toto ResourceDictionary. Podrobnosti najdete v tématu Sloučené slovníky prostředků.

Použití elementu vlastnosti XAML

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

Hodnoty XAML

oneOrMoreResourceElements
Jeden nebo více prvků objektu, z nichž každý definuje prostředek. Každý prvek vlastnosti prostředku v rámci každého ResourceDictionary musí mít jedinečnou hodnotu pro direktivu x:Key, která slouží jako jedinečný klíč při načtení hodnot z ResourceDictionary.

Platí pro

Viz také