Condividi tramite

Attributo mc:Ignorable

  • Articolo

Specifica quali prefissi dello spazio dei nomi XML rilevati in un file di markup possono essere ignorati da un processore XAML. L'attributo mc:Ignorable supporta la compatibilità del markup sia per il mapping di namespace personalizzati che per il versioning XAML.

Utilizzo di attributo XAML (prefisso singolo)

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

Utilizzo degli attributi XAML (due prefissi)

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

Valori XAML

Valore Descrizione
ignorablePrefix, ignorablePrefix1 e così via Qualsiasi stringa di prefisso valida, in base alla specifica XML 1.0.
ignorableUri Qualsiasi URI valido per la designazione di uno spazio dei nomi, in base alla specifica XML 1.0.
ThisElementCanBeIgnored Elemento che può essere ignorato dalle implementazioni del processore XAML (Extensible Application Markup Language), se il tipo sottostante non può essere risolto.

Osservazioni

Il prefisso dello spazio dei nomi XML mc è la convenzione di prefisso consigliata da usare quando si esegue il mapping dello spazio dei nomi di compatibilità XAML http://schemas.openxmlformats.org/markup-compatibility/2006.

Elementi o attributi in cui la parte del prefisso del nome dell'elemento viene identificata come mc:Ignorable non genereranno errori quando vengono elaborati da un processore XAML. Se tale attributo non è stato risolto in un tipo o in un costrutto di programmazione sottostante, tale elemento viene ignorato. Si noti però che gli elementi ignorati potrebbero comunque generare errori di analisi aggiuntivi a causa di requisiti di elementi aggiuntivi che sono effetti collaterali del mancato processamento di quell'elemento. Ad esempio, un particolare modello di contenuto elemento potrebbe richiedere esattamente un elemento figlio, ma se l'elemento figlio specificato si trovava in un prefisso mc:Ignorable e l'elemento figlio specificato non può essere risolto in un tipo, il processore XAML potrebbe generare un errore.

mc:Ignorable si applica solo alle mappature degli spazi dei nomi alle stringhe degli identificatori. mc:Ignorable non si applica ai mapping degli spazi dei nomi negli assembly, che specificano uno spazio dei nomi CLR e un assembly (o predefiniscono l'eseguibile corrente come assembly).

Se si implementa un processore XAML, l'implementazione del processore non deve generare errori di analisi o elaborazione per la risoluzione dei tipi per qualsiasi elemento o attributo qualificato da un prefisso identificato come mc:Ignorable. Tuttavia, l'implementazione del processore può comunque sollevare eccezioni come risultato secondario di un elemento che non riesce a caricarsi o a essere elaborato, come nel caso dell'esempio dell'elemento figlio unico menzionato in precedenza.

Per impostazione predefinita, un processore XAML ignorerà il contenuto all'interno di un elemento ignorato. Tuttavia, è possibile specificare un attributo aggiuntivo, attributo mc:ProcessContent, per richiedere il proseguimento dell'elaborazione del contenuto di un elemento ignorato da parte dell'elemento padre successivo disponibile.

È possibile specificare più prefissi nell'attributo usando uno o più caratteri di spazio vuoto come separatore, ad esempio mc:Ignorable="ignore1 ignore2".

Lo spazio dei nomi http://schemas.openxmlformats.org/markup-compatibility/2006 definisce altri elementi e attributi non documentati all'interno di questa area dell'SDK. Per ulteriori informazioni, vedere Specifica di Compatibilità del Markup XML.

Vedere anche