mc:Ignorable, attribut

Article
08/22/2008

Mise à jour : novembre 2007

Spécifie les préfixes de l'espace de noms XML rencontrés dans un fichier balise qui peuvent être ignorés par un processeur XAML. L'attribut mc:Ignorable prend en charge la compatibilité de balise pour le mappage de l'espace de noms personnalisé et le versioning XAML.

Utilisation des attributs XAML (un seul préfixe)

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

Utilisation des attributs XAML (deux préfixes)

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

Valeurs XAML

ignorablePrefix, ignorablePrefix1, etc.	Toute chaîne de préfixes valide, conformément à la spécification XML 1.0.
ignorableUri	Tout URI valide pour la désignation d'un espace de noms, conformément à la spécification XML 1.0.
ThisElementCanBeIgnored	Élément pouvant être ignoré par les implémentations de processeur XAML (Extensible Application Markup Language), si le type sous-jacent ne peut pas être résolu.

Notes

Le préfixe d'espace de noms mcXML est la convention de préfixe recommandée à utiliser lors du mappage de l'espace de noms de compatibilité https://schemas.openxmlformats.org/markup-compatibility/2006XAML.

Les éléments ou les attributs dans lesquels la partie préfixe du nom de l'élément est identifiée en tant que mc:Ignorable ne déclenchent pas d'erreurs lorsqu'ils sont traités par un processeur XAML. Si cet attribut n'a pas pu être résolu vers un type sous-jacent ou une construction de programmation, cet élément est ignoré. Notez toutefois que les éléments ignorés peuvent générer des erreurs d'analyse supplémentaires pour des spécifications d'élément supplémentaires. Ces erreurs sont une des conséquences du fait que cet élément n'est pas traité. Par exemple, un modèle de contenu d'élément particulier peut exiger exactement un élément enfant, mais si l'élément enfant spécifié était dans un préfixe mc:Ignorable et n'a pas pu être résolu vers un type, le processeur XAML peut déclencher une erreur.

mc:Ignorable s'applique uniquement aux mappages d'espace de noms à des chaînes d'identification. Il ne s'applique pas aux mappages d'espace de noms dans les assemblys, qui spécifient un espace de noms CLR et un assembly (ou renvoient par défaut le fichier exécutable actuel en tant qu'assembly).

Si vous implémentez un processeur XAML, votre implémentation de processeur ne doit pas déclencher d'erreurs d'analyse ou de traitement sur la résolution de type pour tout élément ou attribut qualifié par un préfixe identifié comme mc:Ignorable. Votre implémentation de processeur peut toutefois continuer à déclencher des exceptions dues à l'impossibilité de charger ou de traiter un élément, tel que l'exemple d'élément à enfant unique présenté un peu plus tôt.

Par défaut, un processeur XAML ignore le contenu d'un élément ignoré. Vous pouvez toutefois spécifier un attribut supplémentaire, mc:ProcessContent, attribut, afin de demander la poursuite du traitement du contenu d'un élément ignoré par l'élément parent disponible suivant.

Plusieurs préfixes peuvent être spécifiés dans l'attribut, en utilisant un ou plusieurs caractères d'espace blanc en guise de séparateur. Par exemple : mc:Ignorable="ignore1 ignore2".

L'espace de noms https://schemas.openxmlformats.org/markup-compatibility/2006 définit d'autres éléments et attributs qui ne sont pas documentés dans cette zone du Kit de développement logiciel (SDK). Pour plus d'informations, consultez XML Markup Compatibility Specification.