Resolvendo recursos externos
A propriedade XmlResolver do XmlDocument é usada pela classe XmlDocument para localizar os recursos que não são embutidos nos dados XML, como definições de tipo de documento (DTDs), entidades e esquemas externos. Esses itens podem ser localizados em uma rede ou em uma unidade local, e são identificáveis por Uniform Resource Identifier (URI). Isso permite que o XmlDocument resolva os nós de EntityReference presentes no documento e valide o documento de acordo com DTDs ou esquema externos.
XmlDocument totalmente confiável
A propriedade XmlResolver afeta a funcionalidade do método XmlDocument.Load. A tabela abaixo mostra como funciona a propriedade XmlDocument.XmlResolver quando o objeto XmlDocument é totalmente confiável. A tabela a seguir mostra os métodos XmlDocument.Load quando a entrada para a carga é TextReader, String, Stream ou URI. Esta tabela não se aplicará ao método Carga se o XmlDocument for carregado do XmlReader.
| Propriedade de XmlResolver | Função | Observações |
|---|---|---|
| A propriedade é definida como classe XmlResolver criada previamente e com as propriedades já definidas nela pelo usuário. | O XmlDocument usa o XmlResolver fornecido para resolver nomes de arquivo e referências a recursos externos, como DTDs, entidades e esquemas. O XmlResolver também é usado para resolver recursos externos necessários ao adicionar ou editar nós no XmlDocument. |
O XmlResolver dado ao XmlDocument é o resolvedor usado sempre que recursos externos precisam ser localizados e resolvidos. |
| A propriedade é definida como nula (Nothing no Microsoft Visual Basic .NET). | Os recursos que exigem um recurso externo não são suportados, como localizar um esquema externo, ou o DTD. Nem as entidades externos serão resolvidas, e executar funções de edição, como inserir os nós de entidade que exigem resolução, não é suportado. | O XmlDocument carrega arquivos como anônimos e não tenta resolver qualquer outro recurso. |
| A propriedade não está definida, mas esquerda em seu estado padrão. | Um XmlUrlResolver com credenciais NULAS será instanciado e usado pelo XmlDocument ao resolver nomes de arquivos e localizar DTDs, entidades e esquemas externos, e as credenciais nulas serão usadas ao editar nós. |
A tabela a seguir mostra o método XmlDocument.Load quando a entrada à Carga é um XmlReader e o XmlDocument é totalmente confiável.
| Propriedade de XmlResolver | Função | Observações |
|---|---|---|
| A classe XmlResolver usada pelo XmlDocument é a mesma que está sendo usada pelo XmlReader. | O XmlDocument usa o XmlResolver atribuído ao XmlReader. A propriedade XmlDocument.Resolver não pode ser definida, independentemente do nível de confiança do XmlDocument, porque está obtendo um XmlResolver do XmlReader. Não tente substituir as configurações de XmlResolver do XmlReader definindo a propriedade do XmlResolver do XmlDocument. |
O XmlReader pode ser o XmlTextReader, o XmlValidatingReader ou um leitor personalizado. Se o leitor usado oferece suporte a resolução de entidade, as entidades externos são resolvidas. Se o leitor passado não oferece suporte a referências a entidades, então as referências a entidades não são resolvidas. |
XmlDocument de confiança parcial
A tabela a seguir mostra como funciona a propriedade XmlDocument.XmlResolver quando o objeto é de confiança parcial. Esta tabela se aplica aos métodos XmlDocument.Load quando a entrada à Carga é um TextReader, uma String, um Stream ou URI. Esta tabela não se aplicará ao método Carga se o XmlDocument for carregado do XmlReader.
| Propriedade de XmlResolver | Função | Observações |
|---|---|---|
| No cenário de confiança parcial, a propriedade XmlResolver só pode ser definida como nula. | Um XmlUrlResolver com credenciais nulas será instanciado e usado pelo XmlDocument ao resolver nomes de arquivo e localizar DTDs, entidades e esquemas externos, e as credenciais nulas serão usadas ao editar nós. | Esse comportamento é idêntico ao apresentado quando a propriedade XmlResolver não está definida, mas deixada no estado padrão. O XmlDocument usa permissões anônimas para todas as ações. |
| A propriedade é definida como nula (Nothing no Microsoft Visual Basic .NET). | Nenhum recurso que requer um recurso externo é suportado, como localizar um esquema externo ou um DTD. Nem as entidades externos serão resolvidas, e executar funções de edição como inserir os nós de entidade que exigem resolução, não é suportado. | Quando a propriedade é nula, o comportamento é o mesmo, não importando se o XmlDocument é total ou parcialmente confiável. |
| A propriedade não está definida, mas esquerda em seu estado padrão. | Um XmlUrlResolver com credenciais nulas será instanciado e usado pelo XmlDocument ao resolver nomes de arquivo e localizar DTDs, entidades e esquemas externos, e as credenciais nulas serão usadas ao editar nós. | O XmlDocument usa permissões anônimas para todas as ações. |
Esta tabela se aplica ao método XmlDocument.Load quando a entrada à Carga é um XmlReader e o XmlDocument tem confiança parcial.
| Propriedade de XmlResolver | Função | Observações |
|---|---|---|
| A classe XmlResolver usada pelo XmlDocument é a mesma que está sendo usada pelo XmlReader. | O XmlDocument usa o XmlResolver atribuído ao XmlReader. A propriedade XmlDocument.Resolver não pode ser definida, independentemente do nível de confiança do XmlDocument, porque está obtendo um XmlResolver do XmlReader. Não tente substituir as configurações de XmlResolver do XmlReader definindo a propriedade do XmlResolver do XmlDocument. |
O XmlReader pode ser o XmlTextReader, o XmlReader de validação ou um leitor personalizado. Se o leitor usado oferece suporte a resolução de entidade, as entidades externos são resolvidas. Se o leitor passado não oferece suporte a referências a entidades, então as referências a entidades não são resolvidas. |
Defina o XmlResolver para conter as credenciais corretas permite acesso aos recursos externos.
Observação
Não é possível recuperar a propriedade XmlResolver. Isso ajuda a impedir que um usuário reutilize um XmlResolver em que as credenciais foram definidas. Além disso, se um XmlTextReader ou um XmlReader de validação for usado para carregar o XmlDocument e o XmlDocument tiver um resolvedor definido, os resolvedores desses leitores não serão armazenados em cache pelo XmlDocument após a fase de Carga, pois isso também apresenta um risco de segurança.
Para obter mais informações, consulte a seção de Comentários da página de referência XmlResolver.
