XmlnsPrefixAttribute Klas

Definitie

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

Overname

Object

Attribute

XmlnsPrefixAttribute

Kenmerken

AttributeUsageAttribute

Opmerkingen

XAML-processors of -frameworks die XAML bevatten, of een proces dat XAML-serialisatie uitvoert, moeten over het algemeen het aanbevolen voorvoegsel respecteren. Het voorvoegsel kan nodig zijn in elk geval wanneer voorvoegsels van specifieke toewijzingen in de oorspronkelijke XAML-bron niet op de een of andere manier worden bewaard in de runtimeobjectgrafiek of anderszins worden opgeslagen door een framework of technologie. Een framework kan specifieke voorkeuren hebben voor het serialiseren van zijn eigen typen die het aanbevolen voorvoegsel van eigen assembly's negeren; Dit kan worden gedaan om een standaard XAML-naamruimte consistent te promoten. Een dergelijk framework moet echter nog steeds aanbevolen voorvoegsels bieden voor mogelijk gebruik van derden en hulpprogramma's van de XAML-typen. Zie de sectie 'Best Practice for XAML Designer Support or General Serialization' hieronder.

Een algemene aanbeveling voor voorvoegsels is het gebruik van korte tekenreeksen, omdat het voorvoegsel doorgaans wordt toegepast op alle geserialiseerde elementen die afkomstig zijn van de XAML-naamruimte. De lengte van de tekenreeks voor het voorvoegsel kan een merkbaar effect hebben op de grootte van de geserialiseerde XAML-uitvoer.

Als een aangevraagd voorvoegsel al wordt gebruikt door een andere eerder aangetroffen/geserialiseerde XAML-naamruimte-id, is het gedrag niet opgegeven (gedrag is aan elke afzonderlijke XAML-processor-implementatie).

In de meeste gevallen past u alleen toe XmlnsPrefixAttribute als u ook ten minste één XmlnsDefinitionAttribute in de assembly hebt toegepast voor dezelfde XAML-naamruimte.

In eerdere versies van het .NET Framework bestond deze klasse in de WPF-specifieke assembly WindowsBase. In .NET Framework 4 bevindt XmlnsPrefixAttribute zich in de System.Xaml-assembly. Zie Types gemigreerd van WPF naar System.Xaml voor meer informatie.

Aanbevolen procedure voor XAML Designer-ondersteuning of algemene serialisatie

Zelfs als u van plan bent dat de bijbehorende XAML-naamruimte de standaard XAML-naamruimte is in de meeste gevallen voor uw framework of bibliotheek, moet u nog steeds een niet-lege tekenreeks opgeven als het aanbevolen voorvoegsel voor een XAML-naamruimte. Standaardinformatie over de XAML-naamruimte wordt uitgevoerd in afzonderlijke XAML-bestanden en XAML-knooppuntstromen. De standaard XAML-naamruimte en hoe deze in een bepaalde XAML-bron wordt gedefinieerd, kan eenvoudig worden gedumpeerd voor serialisatie per geval zonder gebruik te maken XmlnsPrefixAttribute. Het XmlnsPrefixAttribute is echter handig voor gevallen waarin de auteur van XAML ervoor heeft gekozen om de standaard XAML-naamruimte toe te wijzen aan iets anders. In dit scenario kan een XAML-teksteditor die is ingesloten in een ontwerpomgeving, worden gebruikt XmlnsPrefixAttribute als hint voor een eerste XAML-naamruimtetoewijzing xmlns . Of een ontwerpomgeving kan Just-In-Time-toewijzingen toevoegen aan de backing XAML voor ontwerpaforen, zoals het uit een werkset slepen van objecten en naar een visueel ontwerpoppervlak. Het is ook mogelijk dat een ontwerper tegelijkertijd meerdere XAML-frameworks kan ondersteunen en een gemeenschappelijke XAML-serializer heeft die afhankelijk is van .NET Framework XAML-services in plaats van frameworkspecifieke serialisatie. Als u een XmlnsPrefixAttribute voor deze scenario's opgeeft, kunt u het XAML-gebruik voor uw typen draagbaarder en robuuster maken als de XAML wordt uitgewisseld tussen ontwerphulpprogramma's of een retour tussen XAML-editors en andere consumenten, zoals markeringscompilers of andere serialisatie.

Zie ook

• XAML-gerelateerde CLR-kenmerken voor aangepaste typen en bibliotheken
• Definieerde aangepaste typen voor gebruik met .NET XAML Services
• XAML-services