Dela via


mc:Ignorerbar attribut

Anger vilka XML-namnområdesprefix som påträffas i en markeringsfil som kan ignoreras av en XAML-processor. Attributet mc:Ignorable stöder markeringskompatibilitet både för mappning av anpassade namnområden och för XAML-versionshantering.

XAML-attributanvändning (enskilt prefix)

<object
  xmlns:ignorablePrefix="ignorableUri"
  xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
  mc:Ignorable="ignorablePrefix"...>
    <ignorablePrefix1:ThisElementCanBeIgnored/>
</object>

XAML-attributanvändning (två prefix)

<object
  xmlns:ignorablePrefix1="ignorableUri"
  xmlns:ignorablePrefix2="ignorableUri2"
  xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
  mc:Ignorable="ignorablePrefix1 ignorablePrefix2"...>
    <ignorablePrefix1:ThisElementCanBeIgnored/>
</object>

XAML-värden

Värde Beskrivning
ignorablePrefix, ignorablePrefix1 osv. Alla giltiga prefixsträngar enligt XML 1.0-specifikationen.
ignorableUri Alla giltiga URI:er för att utse ett namnområde enligt XML 1.0-specifikationen.
ThisElementCanBeIgnored Ett element som kan ignoreras av XAML-processorimplementeringar (Extensible Application Markup Language) om den underliggande typen inte kan matchas.

Anmärkningar

XML-namnrymdsprefixet mc är den rekommenderade konventionen att använda vid mappning av XAML-kompatibilitetsnamnrymden http://schemas.openxmlformats.org/markup-compatibility/2006.

Element eller attribut där prefixdelen av elementnamnet identifieras som mc:Ignorable genererar inga fel när de bearbetas av en XAML-processor. Om attributet inte kunde matchas till en underliggande typ eller programmeringskonstruktion ignoreras det elementet. Observera dock att ignorerade element fortfarande kan generera ytterligare parsningsfel för ytterligare elementkrav som är biverkningar av att elementet inte bearbetas. En viss elementinnehållsmodell kan till exempel kräva exakt ett underordnat element, men om det angivna underordnade elementet fanns i ett mc:Ignorable prefix och det angivna underordnade elementet inte kunde matchas till en typ kan XAML-processorn generera ett fel.

mc:Ignorable gäller endast namnområdesmappningar för identifierarsträngar. mc:Ignorable gäller inte för namnområdesmappningar till sammansättningar, som anger ett CLR-namnområde och en sammansättning (eller som standard den aktuella körbara filen som sammansättning).

Om du implementerar en XAML-processor får processorimplementeringen inte generera parsnings- eller bearbetningsfel vid typmatchning för något element eller attribut som är kvalificerat av ett prefix som identifieras som mc:Ignorable. Men processorimplementeringen kan fortfarande generera undantag som är ett sekundärt resultat av att ett element inte kan läsas in eller bearbetas, till exempel exemplet med ett underordnat element som angavs tidigare.

Som standard ignorerar en XAML-processor innehåll i ett ignorerat element. Du kan dock ange ytterligare ett attribut, mc:ProcessContent Attribute, för att kräva fortsatt bearbetning av innehåll i ett ignorerat element av nästa tillgängliga överordnade element.

Flera prefix kan anges i attributet med ett eller flera blankstegstecken som avgränsare, till exempel: mc:Ignorable="ignore1 ignore2".

http://schemas.openxmlformats.org/markup-compatibility/2006-namnområdet definierar andra element och attribut som inte dokumenteras inom det här området i SDK:et. Mer information finns i XML-kompatibilitetsspecifikation.

Se även