XmlnsPrefixAttribute Třída

Definice

Obor názvů:

System.Windows.Markup

Sestavení:

System.Xaml.dll

Identifikuje doporučenou předponu pro přidružení 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 návrhovým prostředím, 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é obsahují XAML, nebo jakýkoli proces, který provádí serializaci XAML, by obecně měly dodržovat doporučenou předponu. Předpona může být nezbytná v každém případě, kdy předpony z konkrétních mapování v původním zdroji XAML nejsou v grafu objektu modulu runtime zachovány nebo jinak uloženy architekturou nebo technologií. Architektura může mít specifické předvolby pro serializaci vlastních typů, které ignorují doporučenou předponu z vlastních sestavení; to může být provedeno tak, aby konzistentně propagoval výchozí obor názvů XAML. Tato architektura by ale měla i nadále poskytovat doporučené předpony pro možné použití typů XAML třetích stran a nástrojů. Níže najdete část "Osvědčený postup pro podporu návrháře XAML nebo obecné serializace".

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

Pokud se požadovaná předpona již používá jiným dříve zjištěným nebo serializovaným identifikátorem oboru názvů XAML, chování není zadané (chování je až u každé implementace jednotlivých procesorů 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 existovala tato třída v sestavení wpF specifickém pro WindowsBase. V rozhraní .NET Framework 4 XmlnsPrefixAttribute je v sestavení System.Xaml. Další informace naleznete v tématu Typy migrované z WPF do System.Xaml.

Osvědčený postup pro podporu návrháře XAML nebo obecné serializace

I když máte v úmyslu, aby přidružený obor názvů XAML byl výchozím oborem názvů XAML ve většině případů použití pro vaši architekturu nebo knihovnu, měli byste jako doporučenou předponu oboru 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 datových proudech uzlů XAML. Výchozí obor názvů XAML a jeho definice v daném zdroji XAML lze snadno zachovat pro serializaci jednotlivých případů bez použití XmlnsPrefixAttribute. To je ale užitečné v případech, XmlnsPrefixAttribute kdy se autor XAML rozhodl namapovat 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 v návrhovém prostředí můžete do backingu XAML přidat mapování za běhu pro metafory návrhu, například přetažení objektů z panelu nástrojů a do návrhové plochy vizuálu. Je také 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 Framework XAML namísto serializace specifické pro architekturu. Určení XmlnsPrefixAttribute pro tyto scénáře pomáhá usnadnit použití XAML pro vaše typy a robustnější, pokud se XAML vyměňuje mezi nástroji pro návrh nebo prochází odezvou mezi editory XAML a dalšími uživateli, jako jsou kompilátory značek nebo jiné serializace.

Konstruktory

Name	Description
XmlnsPrefixAttribute(String, String)	Inicializuje novou instanci XmlnsPrefixAttribute třídy.

Vlastnosti

Name	Description
Prefix	Získá doporučenou předponu přidruženou k tomuto atributu.
XmlNamespace	Získá identifikátor oboru názvů XAML přidružený k tomuto atributu.

Viz také

• Atributy CLR související s XAML pro vlastní typy a knihovny
• Definovat vlastní typy pro použití se službami XAML .NET
• Služby XAML