Partilhar via


mc:Atributo ignorado

Especifica quais prefixos de namespace XML encontrados em um arquivo de marcação podem ser ignorados por um processador XAML. O atributo mc:Ignorable oferece suporte à compatibilidade de marcação tanto para mapeamento de namespace personalizado quanto para versionamento XAML.

Uso de atributo XAML (prefixo único)

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

Uso de atributos XAML (dois prefixos)

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

Valores XAML

Valor Descrição
ignorablePrefix, ignorablePrefix1, etc. Qualquer cadeia de caracteres de prefixo válida, de acordo com a especificação XML 1.0.
ignorávelUri Qualquer URI válido para designar um namespace, de acordo com a especificação XML 1.0.
ThisElementCanBeIgnored Um elemento que pode ser ignorado por implementações de processador XAML (Extensible Application Markup Language), se o tipo subjacente não puder ser resolvido.

Observações

O prefixo de namespace XML mc é a convenção de prefixo recomendada a ser usada ao mapear o namespace de compatibilidade XAML http://schemas.openxmlformats.org/markup-compatibility/2006.

Elementos ou atributos em que a parte do prefixo do nome do elemento é identificada como mc:Ignorable não gerarão erros quando processados por um processador XAML. Se esse atributo não puder ser resolvido para um tipo subjacente ou construção de programação, esse elemento será ignorado. No entanto, observe que os elementos ignorados ainda podem gerar erros de análise adicionais para requisitos de elementos adicionais que são efeitos colaterais desse elemento que não está sendo processado. Por exemplo, um modelo de conteúdo de elemento específico pode exigir exatamente um elemento filho, mas se o elemento filho especificado estiver em um prefixo mc:Ignorable e o elemento filho especificado não puder ser resolvido para um tipo, o processador XAML poderá gerar um erro.

mc:Ignorable só se aplica a mapeamentos de namespace para cadeias de caracteres de identificador. mc:Ignorable não se aplica a mapeamentos de namespace em assemblies, que especificam um namespace CLR e um assembly (ou que por padrão usam o executável atual como o assembly).

Se você estiver implementando um processador XAML, sua implementação de processador não deverá gerar erros de análise ou processamento na resolução de tipo para qualquer elemento ou atributo qualificado por um prefixo identificado como mc:Ignorable. Mas a implementação do processador ainda pode gerar exceções que são um resultado secundário de um elemento que não foi carregado ou processado, como o exemplo de elemento único filho dado anteriormente.

Por padrão, um processador XAML ignorará o conteúdo dentro de um elemento ignorado. No entanto, você pode especificar um atributo adicional, mc:ProcessContent Attribute, para exigir o processamento contínuo de conteúdo dentro de um elemento ignorado pelo próximo elemento pai disponível.

Vários prefixos podem ser especificados no atributo, usando um ou mais caracteres de espaço em branco como separador, por exemplo: mc:Ignorable="ignore1 ignore2".

O namespace http://schemas.openxmlformats.org/markup-compatibility/2006 define outros elementos e atributos que não estão documentados nesta área do SDK. Para obter mais informações, consulte "Especificação de Compatibilidade de Marcação XML".

Ver também