Delen via

mc:Negeerbaar kenmerk

  • Artikel

Hiermee geeft u op welke XML-naamruimtevoorvoegsels in een opmaakbestand kunnen worden genegeerd door een XAML-processor. Het kenmerk mc:Ignorable ondersteunt compatibiliteit met markeringen, zowel voor aangepaste naamruimtetoewijzing als voor versiebeheer van XAML.

XAML-attribuutgebruik (enkel voorvoegsel)

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

XAML-kenmerkgebruik (twee voorvoegsels)

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

XAML-waarden

Waarde Beschrijving
ignorablePrefix, ignorablePrefix1, etc. Elke geldige tekenreeks voor het voorvoegsel, volgens de XML 1.0-specificatie.
negeerbareUri Elke geldige URI voor het aanwijzen van een naamruimte volgens de XML 1.0-specificatie.
ThisElementCanBeIgnored Een element dat kan worden genegeerd door XAML-processor-implementaties (Extensible Application Markup Language) als het onderliggende type niet kan worden opgelost.

Opmerkingen

Het voorvoegsel mc voor de XML-naamruimte is de aanbevolen conventie die moet worden gebruikt bij het toewijzen van de XAML-compatibiliteitsnaamruimte http://schemas.openxmlformats.org/markup-compatibility/2006.

Elementen of kenmerken waarbij het voorvoegselgedeelte van de elementnaam wordt geïdentificeerd als mc:Ignorable zal geen fouten veroorzaken bij het verwerken door een XAML-processor. Als dat kenmerk niet kan worden omgezet in een onderliggend type of een programmeerconstructie, wordt dat element genegeerd. Houd er rekening mee dat genegeerde elementen mogelijk nog steeds extra parseringsfouten genereren voor aanvullende elementvereisten die neveneffecten zijn van dat element dat niet wordt verwerkt. Een bepaald elementinhoudsmodel kan bijvoorbeeld exact één onderliggend element vereisen, maar als het opgegeven onderliggende element zich in een mc:Ignorable voorvoegsel bevond en het opgegeven onderliggende element niet kon worden omgezet in een type, kan de XAML-processor een fout veroorzaken.

mc:Ignorable is alleen van toepassing op naamruimtetoewijzingen op id-tekenreeksen. mc:Ignorable is niet van toepassing op naamruimtetoewijzingen in assembly's, waarmee een CLR-naamruimte en een assembly worden opgegeven (of de standaardinstelling voor het huidige uitvoerbare bestand als assembly).

Als u een XAML-processor implementeert, mag uw processorimplementatie geen parserings- of verwerkingsfouten veroorzaken voor een element of kenmerk dat is gekwalificeerd door een voorvoegsel dat wordt geïdentificeerd als mc:Ignorable. Maar uw processor-implementatie kan nog steeds uitzonderingen genereren die een secundair resultaat zijn van een element dat niet kan worden geladen of verwerkt, zoals het voorbeeld van een onderliggend element dat eerder is gegeven.

Standaard negeert een XAML-processor inhoud binnen een genegeerd element. U kunt echter een extra kenmerk opgeven, mc:ProcessContent Attribute, om continue verwerking van inhoud binnen een genegeerd element te vereisen door het volgende beschikbare bovenliggende element.

Er kunnen meerdere voorvoegsels worden opgegeven in het kenmerk, met behulp van een of meer spatietekens als scheidingsteken, bijvoorbeeld: mc:Ignorable="ignore1 ignore2".

De http://schemas.openxmlformats.org/markup-compatibility/2006 naamruimte definieert andere elementen en kenmerken die niet in dit gebied van de SDK worden gedocumenteerd. Zie compatibiliteitsspecificatie voor XML-markeringenvoor meer informatie.

Zie ook