Share via


mc:Ignorable 属性

マークアップ ファイル内で検出された XML 名前空間プレフィックスのうち、XAML プロセッサで無視してよいものを指定します。 mc:Ignorable 属性はカスタム ネームスペースのマッピングと XAML バージョン管理のための互換性のあるマークアップをサポートします。

XAML 属性の使用方法 (1 つのプレフィックス)

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

XAML 属性の使用方法 (2 つのプレフィックス)

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

XAML 値

ignorablePrefix、ignorablePrefix1 など

XML 1.0 仕様ごとの有効なプレフィックス文字列。

ignorableUri

XML 1.0 仕様ごとに名前空間を指定する有効な URI。

ThisElementCanBeIgnored

基になる型を解決できない場合に、Extensible Application Markup Language (XAML) プロセッサ実装により無視できる要素。

解説

この mc XML 名前空間プレフィックスは、互換性のある XAML の名前空間 https://schemas.openxmlformats.org/markup-compatibility/2006 を割り当てるときに使用する推奨プレフィックス規則です。

要素名のプレフィックス部分が mc:Ignorable として識別される要素または属性は、XAML プロセッサで処理されるとき、エラーを発生しません。 その属性を基になる型またはプログラミング構成体に解決できない場合、その要素は無視されます。 ただし、無視された要素は、その未処理の影響である追加要素の要件に関して、追加の解析エラーを生成する可能性もあるので注意してください。 たとえば、特定の要素のコンテンツ モデルが 1 つだけの子要素を必要とするときに、指定された子要素が mc:Ignorable プレフィックスにあると型に解決できないので、XAML プロセッサはエラーを発生させる場合があります。

mc:Ignorable は、識別子文字列への名前空間の割り当てにのみ適用されます。 mc:Ignorable は、CLR 名前空間およびアセンブリ (または、既定でアセンブリとして現在実行可能なファイル) を指定する、アセンブリへの名前空間の割り当てには適用されません。

XAML プロセッサを実装する場合、プロセッサの実装では、mc:Ignorable として識別されるプレフィックスが修飾する要素または属性の型解決について、解析エラーまたは処理エラーを発生させることはできません。 ただし、プロセッサの実装では例外が発生することもあり、この例外は、前述した 1 つの子要素の例のように、要素の読み込みまたは処理の失敗の 2 次的な結果です。

既定では、XAML プロセッサは、無視された要素内のコンテンツを無視します。 ただし、追加属性、つまり mc:ProcessContent 属性を指定して、次に使用可能な親要素による無視された要素内のコンテンツの継続処理を要求できます。

複数のプレフィックスは、たとえば、mc:Ignorable="ignore1 ignore2" のように 1 つ以上の空白文字を区切り記号として使用して、属性内で指定できます。

https://schemas.openxmlformats.org/markup-compatibility/2006 名前空間は、software development kit (SDK) のこの領域には記載されていないその他の要素や属性を定義します。 詳細については、「XML マークアップの互換性の仕様」を参照してください。

参照

参照

PresentationOptions:Freeze 属性

XamlReader

概念

XAML の概要 (WPF)

WPF のドキュメント