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.