XmlReaderSettings.XmlResolver Propriedade

Definição

Define o XmlResolver usado para aceder a 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 de Propriedade

Um XmlResolver usado para aceder a documentos externos. Se definido como null, e XmlException é lançado quando tenta XmlReader aceder a um recurso externo. O padrão é um novo XmlUrlResolver , sem credenciais. A partir do .NET Framework 4.5.2, esta definição tem um valor predefinido de null.

Observações

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

Importante

Como podem XmlResolver conter informações sensíveis, como credenciais de utilizador, deve ter cuidado ao armazenar XmlReaderSettings objetos em cache ou ao passar o XmlReaderSettings objeto de um componente para outro.

Usar 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 flags estão ativados, o XmlResolver do objeto XmlReaderSettings é utilizado para resolver localizações de esquema encontradas no documento de instância no XmlReader. Se o XmlResolver objeto for null, os locais do esquema não serão resolvidos, mesmo que os sinalizadores de validação ProcessInlineSchema e ProcessSchemaLocation estejam 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 a partir de fontes confiáveis.

Aplica-se a

Ver também