XmlReaderSettings.XmlResolver Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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; }member this.XmlResolver : System.Xml.XmlResolverPublic Property XmlResolver As XmlResolverValor 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.
Exemplos
O exemplo seguinte cria um XmlReader que usa um XmlSecureResolver com credenciais por defeito.
// Create an XmlSecureResolver with default credentials.
XmlSecureResolver myResolver = new XmlSecureResolver(new XmlUrlResolver(), "http://serverName/data/");
myResolver.Credentials = CredentialCache.DefaultCredentials;
XmlReaderSettings settings = new XmlReaderSettings();
settings.XmlResolver = myResolver;
// Create the reader.
XmlReader reader = XmlReader.Create("http://serverName/data/books.xml", settings);
' Create an XmlSecureResolver with default credentials.
Dim myResolver As New XmlSecureResolver(New XmlUrlResolver(), "http://serverName/data/")
myResolver.Credentials = CredentialCache.DefaultCredentials
Dim settings As New XmlReaderSettings()
settings.XmlResolver = myResolver
' Create the reader.
Dim reader As XmlReader = XmlReader.Create("http://serverName/data/books.xml", settings)
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.
An pode ser usado para aceder a XmlSecureResolver documentos externos. A XmlSecureResolver classe ajuda a garantir outra implementação de XmlResolver ao envolver o XmlResolver objeto e restringir os recursos a que o subjacente XmlResolver tem acesso.
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.