Compartilhar via

Atributo mc:Ignorable

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

Uso do atributo XAML (prefixo único)

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

Uso do atributo 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.
ignorableUri 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 do 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 se aplica somente 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 assembly e um namespace de CLR (ou usam o executável atual como assembly por padrão).

Se você estiver implementando um processador XAML, a implementação do 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. Contudo, a implementação do processador pode, ainda assim, gerar exceções que são um resultado secundário da falha de um elemento ao carregar ou ser processado, como no exemplo de filho único fornecido anteriormente.

Por padrão, um processador XAML ignorará o conteúdo em um elemento ignorado. No entanto, você pode especificar um atributo adicional, mc:ProcessContent Attribute, para exigir o processamento contínuo de conteúdo em 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 nessa área do SDK. Para obter mais informações, consulte a Especificação de Compatibilidade de Marcação XML .

Consulte também

  • Last updated on