XmlnsPrefixAttribute Klass

Definition

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

Arv

Object

Attribute

XmlnsPrefixAttribute

Attribut

AttributeUsageAttribute

Kommentarer

XAML-processorer eller ramverk som innehåller XAML, eller alla processer som utför XAML-serialisering, bör vanligtvis följa det rekommenderade prefixet. Prefixet kan vara nödvändigt i alla fall där prefix från specifika mappningar i den ursprungliga XAML-källan inte på något sätt bevaras i körningsobjektdiagrammet eller på annat sätt lagras av ett ramverk eller en teknik. Ett ramverk kan ha specifika inställningar för hur du serialiserar sina egna typer som ignorerar det rekommenderade prefixet från sina egna sammansättningar. Detta kan göras för att konsekvent höja upp ett XAML-standardnamnområde. Ett sådant ramverk bör dock fortfarande tillhandahålla rekommenderade prefix för möjliga användningar från tredje part och verktyg av dess XAML-typer. Se avsnittet "Bästa praxis för XAML Designer-support eller allmän serialisering" nedan.

En allmän rekommendation för prefix är att använda korta strängar, eftersom prefixet vanligtvis tillämpas på alla serialiserade element som kommer från XAML-namnområdet. Prefixsträngens längd kan ha en märkbar effekt på storleken på serialiserade XAML-utdata.

Om ett prefix som begärs redan används av en annan tidigare påträffad/serialiserad XAML-namnområdesidentifierare är beteendet ospecificerat (beteendet är upp till varje enskild XAML-processorimplementering).

I de flesta fall gäller XmlnsPrefixAttribute endast om du också har tillämpat minst en XmlnsDefinitionAttribute i sammansättningen för samma XAML-namnområde.

I tidigare versioner av .NET Framework fanns den här klassen i den WPF specifika sammansättningen WindowsBase. I .NET Framework 4 finns XmlnsPrefixAttribute i System.Xaml-sammansättningen. Mer information finns i Types Migrerad från WPF till System.Xaml.

Bästa praxis för XAML Designer-support eller allmän serialisering

Även om du tänker att det associerade XAML-namnområdet ska vara standard-XAML-namnområdet i de flesta användningsfall för ditt ramverk eller bibliotek, bör du fortfarande ange en icke-tom sträng som det rekommenderade prefixet för ett XAML-namnområde. Standardinformationen för XAML-namnområdet finns i enskilda XAML-filer och XAML-nodströmmar. XAML-standardnamnområdet och hur det definieras i en viss XAML-källa kan enkelt vidmakthållas för serialisering per fall utan att använda XmlnsPrefixAttribute. Är dock XmlnsPrefixAttribute användbart för fall där XAML-författaren har valt att mappa standard-XAML-namnområdet till något annat. I det här scenariot kan en XAML-textredigerare som är inbäddad i en designmiljö använda XmlnsPrefixAttribute som ett tips för en första XAML-namnområdesmappning xmlns . En designmiljö kan också lägga till just-in-time-mappningar i XAML för designmetaforer som att dra ut objekt ur en verktygslåda och till en visuell designyta. Dessutom är det tänkbart att en designer samtidigt kan stödja flera XAML-aktiverande ramverk och har en vanlig XAML-serialiserare som förlitar sig på .NET Framework XAML-tjänster i stället för ramverksspecifik serialisering. Genom att ange en XmlnsPrefixAttribute för dessa scenarier blir XAML-användningen för dina typer mer portabel och robust om XAML byts ut mellan designverktyg eller genomgår en tur och retur mellan XAML-redigerare och andra konsumenter, till exempel markeringskompilerare eller annan serialisering.

Se även

• XAML-relaterade CLR-attribut för anpassade typer och bibliotek
• Define anpassade typer för användning med .NET XAML-tjänster
• XAML-tjänster