Freigeben über


mc:Ignorable-Attribut

Gibt an, welche XML-Namespacepräfixe, die in einer Markupdatei gefunden wurden, möglicherweise von einem XAML-Prozessor ignoriert werden. Das mc:Ignorable-Attribut unterstützt Markupkompatibilität sowohl für benutzerdefinierte Namespace-Zuordnungen als auch für die XAML-Versionsverwaltung.

Verwendung von XAML-Attributen (Einzelnes Präfix)

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

Verwendung von XAML-Attributen (Zwei Präfixe)

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

XAML-Werte

ignorablePrefix, ignorablePrefix1 usw.

Eine beliebige gültige Präfixzeichenfolge, gemäß XML 1.0-Spezifikation.

ignorableUri

Ein beliebiger gültiger URI zum Angeben eines Namespaces, gemäß XML 1.0-Spezifikation.

ThisElementCanBeIgnored

Ein Element, das von Extensible Application Markup Language (XAML)-Prozessorimplementierungen ignoriert werden kann, wenn der zugrunde liegende Typ nicht aufgelöst werden kann.

Hinweise

Das mc XML-Namespacepräfix ist die empfohlene Präfixkonvention für die Zuordnung des XAML-Compatibility-Namespaces https://schemas.openxmlformats.org/markup-compatibility/2006.

Elemente oder Attribute, bei denen der Präfixabschnitt des Elementnamens als mc:Ignorable identifiziert wird, lösen keine Fehler aus, wenn sie von einem XAML-Prozessor verarbeitet werden. Wenn dieses Attribut nicht zu einem zugrunde liegenden Typ oder Programmierkonstrukt aufgelöst werden konnte, wird dieses Element ignoriert. Beachten Sie jedoch, dass ignorierte Elemente noch immer zusätzliche Analysefehler für weitere Elementanforderungen auslösen können, die Nebeneffekte des nicht verarbeiteten Elements sind. So erfordert beispielsweise ein bestimmtes Elementinhaltsmodell möglicherweise genau ein untergeordnetes Element. Wenn jedoch das angegebene untergeordnete Element in einem mc:Ignorable-Präfix enthalten war und nicht zu einem Typ aufgelöst werden konnte, löst der XAML-Prozessor möglicherweise einen Fehler aus.

mc:Ignorable gilt nur für Namespacezuordnungen für Bezeichnerzeichenfolgen. mc:Ignorable gilt nicht für Namespacezuordnungen zu Assemblys, die einen CLR-Namespace und eine Assembly angeben (oder standardmäßig die ausführbare Datei als Assembly haben).

Wenn Sie einen XAML-Prozessor implementieren, darf Ihre Prozessorimplementierung keine Analyse- oder Verarbeitungsfehler bei der Typauflösung für ein beliebiges Element oder ein Attribut auslösen, das durch ein Präfix als mc:Ignorable identifiziert wurde. Ihre Prozessorimplementierung kann dennoch Ausnahmen auslösen, die Nebeneffekte davon sind, dass ein Element nicht geladen oder verarbeitet werden kann, wie das zuvor genannte untergeordnete Element.

Standardmäßig ignoriert ein XAML-Prozessor Inhalte innerhalb eines ignorierten Elements. Sie können jedoch ein zusätzliches Attribut angeben, mc:ProcessContent-Attribut, um festzulegen, dass innerhalb eines ignorierten Elements vom nächsten verfügbaren übergeordneten Element eine kontinuierliche Verarbeitung des Inhalts ausgeführt werden muss.

Mehrere Präfixe können im Attribut angegeben werden, indem mindestens ein Leerzeichen als Trennzeichen verwendet wird, z. B.: mc:Ignorable="ignore1 ignore2".

Der https://schemas.openxmlformats.org/markup-compatibility/2006-Namespace definiert andere Elemente und Attribute, die nicht innerhalb dieses software development kit (SDK)-Bereichs dokumentiert sind. Weitere Informationen finden Sie unter Spezifikation für die XML-Markupkompatibilität.

Siehe auch

Referenz

PresentationOptions:Freeze-Attribut

XamlReader

Konzepte

Übersicht über XAML (WPF)

Dokumente in WPF