x:Class – direktiva

  • Článek

Konfiguruje kompilaci značek XAML pro spojení částečných tříd mezi revizemi a kódem za sebou. Částečná třída kódu je definována v samostatném souboru kódu v jazyce CLS (Common Language Specification), zatímco revize částečná třída je obvykle vytvořena generováním kódu během kompilace XAML.

Použití atributu XAML

<object x:Class="namespace.classname"...>
  ...
</object>

Hodnoty XAML

Hodnota Popis
namespace Nepovinné. Určuje obor názvů CLR, který obsahuje částečnou třídu identifikovanou .classname Pokud namespace je zadána, tečka (.) odděluje namespace a classname. Viz poznámky.
classname Povinný: Určuje název CLR částečné třídy, která spojuje načtený KÓD XAML a kód pro daný XAML.

Závislosti

x:Class lze zadat pouze v kořenovém prvku produkčního prostředí XAML. x:Class je neplatný pro všechny objekty, které mají nadřazený objekt v produkčním prostředí XAML. Další informace najdete v části [MS-XAML] 6.3.1.6.

Poznámky

Hodnota namespace může obsahovat další tečky pro uspořádání souvisejících oborů názvů do hierarchií názvů, což je běžná technika programování .NET. Pouze poslední tečka v řetězci x:Class hodnot je interpretována k oddělení namespace a classname. třída, která se používá jako x:Class nemůže být vnořená třída. Vnořené třídy nejsou povoleny, protože určení významu tečk pro x:Class řetězce je nejednoznačné, pokud jsou vnořené třídy povoleny.

V existujících programovacích modelech, které používají x:Class, x:Class je volitelné v tom smyslu, že je zcela platné mít stránku XAML, která nemá žádný kód za sebou. Tato schopnost ale komunikuje s akcemi sestavení, které implementují architektury používající XAML. x:Class funkce je také ovlivněna rolemi, které různé klasifikace obsahu určeného XAML mají v aplikačním modelu a v odpovídajících akcích sestavení. Pokud xaml deklaruje hodnoty atributů zpracování událostí nebo vytvoří instanci vlastních prvků, ve kterých jsou definující třídy ve třídě kódu, musíte poskytnout x:Class odkaz na direktivu (nebo x:Subclass) příslušné třídě pro kód za kódem.

Hodnota x:Class direktivy musí být řetězec, který určuje plně kvalifikovaný název třídy, ale bez jakýchkoli informací o sestavení (ekvivalentní Type.FullName). U jednoduchých aplikací můžete vynechat informace o oboru názvů CLR, pokud je kód za kódem také strukturovaný tímto způsobem (definice kódu začíná na úrovni třídy).

Soubor kódu pro stránku nebo definici aplikace musí být v souboru kódu, který je součástí projektu, který vytváří kompilovanou aplikaci a zahrnuje kompilaci značek. Musíte dodržovat pravidla názvů pro třídy CLR. Další informace naleznete v tématu Pokyny pro návrh architektury. Ve výchozím nastavení musí být publictřída kódu za kódem . Můžete ji ale definovat na jiné úrovni přístupu pomocí direktivy x:ClassModifier.

Tato interpretace atributu se vztahuje pouze na implementaci XAML založenou x:Class na CLR, zejména na .NET XAML Services. Jiné implementace XAML, které nejsou založené na CLR a které nepoužívají .NET XAML Services, můžou použít jiný vzorec rozlišení pro připojení kódu XAML a backing kódu za běhu. Další informace o obecnějších interpretacích x:Classnaleznete v tématu [MS-XAML].

Na určité úrovni architektury je význam x:Class nedefinovaný ve službách .NET XAML. Důvodem je to, že služba .NET XAML Services neurčuje programovací model, pomocí kterého jsou propojené kódy XAML a backing. Další použití x:Class direktivy mohou být implementována konkrétními architekturami, které používají programovací modely nebo aplikační modely k definování způsobu připojení kódu založeného na kódu XAML a CLR. Každá architektura může mít vlastní akce sestavení, které umožňují určité chování nebo konkrétní komponenty, které musí být zahrnuty v prostředí sestavení. V rámci architektury se akce sestavení můžou lišit také v závislosti na konkrétním jazyce CLR, který se používá pro kód na pozadí.

x:Class v programovacím modelu WPF

V aplikacích WPF a modelu x:Class aplikace WPF lze deklarovat jako atribut pro libovolný prvek, který je kořenem souboru XAML a je kompilován (kde je XAML součástí projektu aplikace WPF s Page akcí sestavení) nebo pro Application kořen v definici aplikace kompilované aplikace WPF. x:Class Deklarace elementu jiného než kořenového adresáře stránky nebo kořenového adresáře aplikace nebo v souboru WPF XAML, který není kompilován, způsobí chybu v době kompilace v rámci kompilátoru .NET Framework 3.0 a .NET Framework 3.5 WPF XAML. Informace o dalších aspektech x:Class zpracování ve WPF naleznete v tématu Code-Behind a XAML v WPF.

x:Class for Windows Workflow Foundation

Pro Windows Workflow Foundation x:Class pojmenujte třídu vlastní aktivity složené zcela v jazyce XAML nebo pojmenujte částečnou třídu stránky XAML pro návrháře aktivit s kódem.

Poznámky k používání silverlightu

x:Class program Silverlight je dokumentován samostatně. Další informace najdete v tématu Funkce jazyka XAML (x:) (Silverlight).

Viz také