Compartilhar via


mc:Ignorable Attribute

Especifica quais prefixos de namespaces XML encontrados em um arquivo de marcação podem ser ignorados por um processador XAML. O atributo mc:Ignorable oferece suporte a compatibilidade de marcação para o mapeamento de espaços de nomes personalizado e a versionamento de XAML.

Uso de atributo XAML (prefixo único)

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

Uso de atributo XAML (dois prefixos)

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

Valores de XAML

ignorablePrefix, ignorablePrefix1, etc.

Qualquer sequência de prefixo válida, pela especificação XML 1.0.

ignorableUri

Qualquer URI válido para designar um espaço de nomes, pela especificação XML 1.0.

ThisElementCanBeIgnored

Um elemento que pode ser ignorado por implementações do processador Extensible Application Markup Language (XAML), se o tipo base não puder ser resolvido.

Comentários

O prefixo de namespace XML mc é a convenção de prefixo recomendada para se usar ao mapear https://schemas.openxmlformats.org/markup-compatibility/2006, o namespace de compatibilidade XAML.

Elementos ou atributos onde o prefixo do nome do elemento é identificado como mc:Ignorable não gerarão erros quando processado por um processador XAML. Se esse atributo não puder ser resolvido para um tipo subjacente ou construção de programação, então esse elemento será ignorado. Observe no entanto que elementos ignorados ainda podem gerar erros de análise adicionais para requisitos de elemento adicionais que são efeitos colaterais do não processamento daquele elemento. Por exemplo, um determinado modelo de conteúdo elemento pode requerer exatamente um elemento-filho, mas se o elemento filho especificado estava em um prefixo mc:Ignorable, e o elemento-filho especificado não pôde ser resolvido para um tipo, então o processador XAML pode gerar um erro.

mc:Ignorable aplica-se somente a mapeamentos de namespace para seqüências de caracteres de identificador. mc:Ignorable não é válido para mapeamentos de namespace em módulos (assemblies), que especificam um CLR espaço para nome e um assembly (ou padrão para o executável do assembly corrente).

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

Por padrão, um processador XAML irá ignorar o conteúdo dentro de um elemento ignorado. No entanto, você pode especificar um atributo adicional, Atributo mc:ProcessContent, para exigir que o processamento do conteúdo dentro de um elemento ignorado continue no próximo elemento-pai disponível.

Diversos prefixos podem ser especificados no atributo, usando um ou mais caracteres de espaço em branco sistema autônomo separador, por exemplo: mc:Ignorable="ignore1 ignore2".

O espaço de nomes https://schemas.openxmlformats.org/markup-compatibility/2006 define outros elementos e atributos que não estão documentados dentro desta área do software development kit (SDK). Para obter mais informações, consulte Especificação de compatibilidade de marcação XML.

Consulte também

Conceitos

XAML Overview

Documentos em Windows Presentation Foundation

Referência

PresentationOptions:Freeze Attribute

XamlReader