System.Xml.XmlReaderSettings.DtdProcessing propriedade

Este artigo fornece observações complementares à documentação de referência para essa API.

A validação de DTD (definição de tipo de documento) é implementada usando as restrições de validade definidas na recomendação XML (Extensible Markup Language) 1.0 (quarta edição) do W3C. DTDs usam uma gramática formal para descrever a estrutura e sintaxe de documentos XML compatíveis; eles especificam o conteúdo e os valores permitidos para o documento XML.

A propriedade DtdProcessing pode ter um dos seguintes valores:

• DtdProcessing.Parse para habilitar o processamento DTD.
• DtdProcessing.Prohibit para lançar uma XmlException exceção quando um DTD for encontrado.
• DtdProcessing.Ignore para desativar o processamento DTD sem avisos ou exceções.

Para executar a validação em um DTD, o XmlReader usa o DTD definida na declaração DOCTYPE de um documento XML. A declaração DOCTYPE pode apontar para um DTD embutido ou pode ser uma referência a um arquivo DTD externo. Para validar um arquivo XML em relação a um DTD:

• Defina a propriedade XmlReaderSettings.DtdProcessing como DtdProcessing.Parse.
• Defina a propriedade XmlReaderSettings.ValidationType como ValidationType.DTD.
• Se o DTD é um arquivo externo armazenado em um recurso de rede que requer autenticação, passe um objeto XmlResolver com as credenciais necessárias para o método Create.

Importante

Se a DtdProcessing propriedade estiver definida como DtdProcessing.Ignore, o XmlReader não relatará os DTDs. Isso significa que o DTD/DOCTYPE será perdido na saída.