mc:Ignorable 属性

  • [アーティクル]

マークアップ ファイルで検出されたどの XML 名前空間プレフィックスを XAML プロセッサで無視できるかを指定します。 mc:Ignorable 属性は、カスタムの名前空間マッピングと XAML のバージョン管理の両方で、マークアップ互換性をサポートします。

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

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

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

<object
  xmlns:ignorablePrefix1="ignorableUri"
  xmlns:ignorablePrefix2="ignorableUri2"
  xmlns:mc="http://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 互換性名前空間をマッピングするときに使用する推奨プレフィックス規則ですhttp://schemas.openxmlformats.org/markup-compatibility/2006。

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

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

XAML プロセッサを実装する場合、mc:Ignorable として識別されるプレフィックスで修飾された要素または属性について、プロセッサ実装で、解析または処理エラーが発生しないようにする必要があります。 しかし、それでも、前に示した 1 つの子要素の例のように、要素が読み込めない、または処理できないために生じる二次的な結果として、プロセッサ実装で例外が発生する可能性があります。

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

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

http://schemas.openxmlformats.org/markup-compatibility/2006 名前空間は、SDK のこの領域ではドキュメント化されていない他の要素および属性を定義します。 詳細については、XML マークアップ互換性仕様に関するセクションを参照してください。

関連項目