XmlReaderSettings.XmlResolver Propriedade

Definição

Define o XmlResolver usado para acessar documentos externos.

public:
 property System::Xml::XmlResolver ^ XmlResolver {  void set(System::Xml::XmlResolver ^ value); };
public System.Xml.XmlResolver? XmlResolver { set; }
public System.Xml.XmlResolver XmlResolver { set; }
member this.XmlResolver : System.Xml.XmlResolver
Public Property XmlResolver As XmlResolver

Valor da propriedade

Um XmlResolver usado para acessar documentos externos. Se definido como null, um XmlException é gerado quando tenta XmlReader acessar um recurso externo. O padrão é um novo XmlUrlResolver sem credenciais. A partir do .NET Framework 4.5.2, essa configuração tem um valor padrão de null.

Comentários

O XmlResolver é usado para localizar e abrir um documento de instância XML ou para localizar e abrir todos os recursos externos referenciados pelo documento da instância XML. Isso pode incluir entidades, DTD ou esquemas. A XmlResolver.Credentials propriedade pode ser usada para especificar as credenciais necessárias para a autenticação de rede.

Importante

Como pode XmlResolver conter informações confidenciais, como credenciais de usuário, você deve ter cuidado ao armazenar objetos em cache XmlReaderSettings ou ao passar o XmlReaderSettings objeto de um componente para outro.

Use ThrowingResolver para restringir o acesso a documentos externos.

Os sinalizadores de validação ProcessInlineSchema e ProcessSchemaLocation de um objeto XmlReaderSettings não são definidos por padrão. Quando esses sinalizadores são definidos, XmlResolver do objeto de XmlReaderSettings é usado para resolver os locais de esquema encontrados no documento de instância em XmlReader. Se o XmlResolver objeto estiver null, os locais de esquema não serão resolvidos mesmo se os sinalizadores ProcessInlineSchema e ProcessSchemaLocation de validação estiverem definidos.

Os esquemas adicionados durante a validação adicionam novos tipos e podem alterar o resultado da validação do documento que está sendo validado. Como resultado, os esquemas externos só devem ser resolvidos de fontes confiáveis.

Aplica-se a

Confira também