XmlnsPrefixAttribute Třída

Definice

public ref class XmlnsPrefixAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=true)]
public sealed class XmlnsPrefixAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=true)>]
type XmlnsPrefixAttribute = class
    inherit Attribute

Public NotInheritable Class XmlnsPrefixAttribute
Inherits Attribute

Dědičnost

Object

Attribute

XmlnsPrefixAttribute

Atributy

AttributeUsageAttribute

Poznámky

Procesory NEBO architektury XAML, které zahrnují XAML, nebo jakýkoli proces, který provádí serializaci XAML, by měly obecně dodržovat doporučenou předponu. Předpona může být nezbytná v každém případě, kdy se předpony z konkrétních mapování v původním zdroji XAML nějakým způsobem nezachovají v grafu objektů modulu runtime nebo nejsou jinak uloženy architekturou nebo technologií. Architektura může mít specifické předvolby pro serializaci svých vlastních typů, které ignorují doporučenou předponu z vlastních sestavení; to může být provedeno za účelem konzistentního povýšení výchozího oboru názvů XAML. Taková architektura by však měla stále poskytovat doporučené předpony pro možné použití nástrojů a třetích stran u svých typů XAML. Projděte si část "Osvědčený postup pro podporu Designer XAML nebo obecnou serializaci" níže.

Obecné doporučení pro předpony je použití krátkých řetězců, protože předpona se obvykle používá pro všechny serializované elementy, které pocházejí z oboru názvů XAML. Délka řetězce předpony může mít znatelný vliv na velikost serializovaného výstupu XAML.

Pokud je požadovaná předpona již používána jiným dříve zjištěným nebo serializovaným identifikátorem oboru názvů XAML, je chování nespecifikované (chování je až pro každou jednotlivou implementaci procesoru XAML).

Ve většině případů použijete XmlnsPrefixAttribute pouze v případě, že jste také použili alespoň jeden XmlnsDefinitionAttribute v sestavení pro stejný obor názvů XAML.

V předchozích verzích rozhraní .NET Framework tato třída existovala v sestavení WindowsBase specifické pro WPF. V rozhraní .NET Framework 4 XmlnsPrefixAttribute je v sestavení System.Xaml. Další informace najdete v tématu Typy migrované z WPF do System.Xaml.

Osvědčené postupy pro podporu Designer XAML nebo obecnou serializaci

I když máte v úmyslu, aby přidružený obor názvů XAML byl ve většině případů použití pro vaši architekturu nebo knihovnu výchozím oborem názvů XAML, měli byste jako doporučenou předponu pro obor názvů XAML zadat neprázdný řetězec. Výchozí informace o oboru názvů XAML se přenášejí v jednotlivých souborech XAML a streamech uzlů XAML. Výchozí obor názvů XAML a způsob jeho definování v daném zdroji XAML lze snadno zachovat pro serializaci jednotlivých velkých a malých písmen bez použití příkazu XmlnsPrefixAttribute. Je však užitečné v případech, XmlnsPrefixAttribute kdy se autor XAML rozhodl mapovat výchozí obor názvů XAML na něco jiného. V tomto scénáři může textový editor XAML vložený do návrhového prostředí použít XmlnsPrefixAttribute jako nápovědu pro počáteční mapování oboru názvů xmlns XAML. Nebo může prostředí návrhu přidat mapování za běhu do pozadí XAML pro metafory návrhu, jako je přetažení objektů z panelu nástrojů na plochu návrhu vizuálu. Také je možné, že návrhář může současně podporovat více architektur podporujících XAML a má společný serializátor XAML, který spoléhá na služby XAML .NET Framework spíše než serializace specifické pro architekturu. Určení parametru XmlnsPrefixAttribute pro tyto scénáře pomáhá zajistit přenositelnost a robustnost použití XAML pro vaše typy, pokud je XAML vyměňován mezi nástroji návrhu nebo prochází odezvou mezi editory XAML a dalšími příjemci, jako jsou kompilátory značek nebo jiné serializace.

Konstruktory

Vlastnosti

Metody

Explicitní implementace rozhraní

Platí pro

Viz také

• Atributy CLR související s XAML pro vlastní typy a knihovny
• Definování vlastních typů pro použití se službami .NET XAML
• XAML Services