FrameworkElement.Resources Vlastnost

Definice

Obor názvů:

System.Windows

Sestavení:

PresentationFramework.dll

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); };

[System.Windows.Markup.Ambient]
public System.Windows.ResourceDictionary Resources { 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

AmbientAttribute

Poznámky

Slovníky prostředků, které lze definovat zcela nebo částečně v jazyce XAML (Extensible Application Markup Language), se obvykle vytvářejí jako prvek vlastnosti a obvykle se nacházejí v kořenovém elementu pro každou jednotlivé stránky 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 libovolné stránky v případě aplikace). Ve většině aplikačních scénářů doporučujeme definovat styly jako objektové prvky 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 povinnosti návrháře od zodpovědností vývojářů 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á přístup k libovolnému prostředku definovanému v každém nadřazeného prvku a rekurzivně vzhůru.

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 určitě přístupné, dokud Loaded nebude vyvolán element, 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 pouze k prostředkům definovaným xaml 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ů. Při přístupu k prostředkům prostřednictvím kódu je v podstatě ekvivalentní odkazu DynamicResource vytvořenému z XAML.

ResourceDictionary Podklad 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 objekt ResourceDictionary. Toto je příklad implicitní syntaxe kolekce; Je možné vynechat značku představující prvek kolekce. Místo toho se zadají prvky přidané jako položky do kolekce. Další informace o implicitních kolekcích a XAML naleznete 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 objektu ResourceDictionary.

Viz také

• Resources
• x:Key – atribut