XmlnsPrefixAttribute Třída

Definice

Obor názvů:

System.Windows.Markup

Sestavení:

System.Xaml.dll

Identifikuje doporučenou předponu, která se má přidružit k oboru názvů XAML pro použití XAML, při zápisu elementů a atributů v souboru XAML (serializace) nebo při interakci s prostředím návrhu, které má funkce pro úpravy XAML.

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

XmlnsPrefixAttribute(String, String)

Inicializuje novou instanci XmlnsPrefixAttribute třídy .

Vlastnosti

Prefix	Získá doporučenou předponu přidruženou k tomuto atributu.
TypeId	Při implementaci v odvozené třídě získá jedinečný identifikátor pro tuto Attributetřídu . (Zděděno od Attribute)
XmlNamespace	Získá identifikátor oboru názvů XAML přidružený k tomuto atributu.

Metody

Equals(Object)	Vrací hodnotu, která určuje, zda je tato instance rovna zadanému objektu. (Zděděno od Attribute)
GetHashCode()	Vrátí hodnotu hash pro tuto instanci. (Zděděno od Attribute)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
IsDefaultAttribute()	Při přepsání v odvozené třídě označuje, zda je hodnota této instance výchozí hodnotou pro odvozenou třídu. (Zděděno od Attribute)
Match(Object)	Při přepsání v odvozené třídě vrátí hodnotu, která označuje, zda se tato instance rovná zadanému objektu. (Zděděno od Attribute)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

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