XmlTextReader.XmlResolver Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Define o XmlResolver usado para resolver referências de DTD.
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
O XmlResolver a ser usado. Se definido como null, os recursos externos não serão resolvidos.
Na versão 1.1 do .NET Framework, o chamador deve ser totalmente confiável para especificar um XmlResolver.
Exemplos
O exemplo a seguir usa a XmlResolver propriedade para especificar as credenciais necessárias para acessar o arquivo em rede.
#using <System.dll>
#using <System.Xml.dll>
using namespace System;
using namespace System::IO;
using namespace System::Xml;
using namespace System::Net;
int main()
{
// Create the reader.
XmlTextReader^ reader = gcnew XmlTextReader( "http://myServer/data/books.xml" );
// Supply the credentials necessary to access the Web server.
XmlUrlResolver^ resolver = gcnew XmlUrlResolver;
resolver->Credentials = CredentialCache::DefaultCredentials;
reader->XmlResolver = resolver;
// Parse the file.
while ( reader->Read() )
{
// Do any additional processing here.
}
// Close the reader.
reader->Close();
}
using System;
using System.IO;
using System.Xml;
using System.Net;
public class Sample {
public static void Main() {
// Create the reader.
XmlTextReader reader = new XmlTextReader("http://myServer/data/books.xml");
// Supply the credentials necessary to access the Web server.
XmlUrlResolver resolver = new XmlUrlResolver();
resolver.Credentials = CredentialCache.DefaultCredentials;
reader.XmlResolver = resolver;
// Parse the file.
while (reader.Read()) {
// Do any additional processing here.
}
// Close the reader.
reader.Close();
}
}
Imports System.IO
Imports System.Xml
Imports System.Net
public class Sample
public shared sub Main()
' Create the reader.
Dim reader as XmlTextReader = new XmlTextReader("http://myServer/data/books.xml")
' Supply the credentials necessary to access the Web server.
Dim resolver as XmlUrlResolver = new XmlUrlResolver()
resolver.Credentials = CredentialCache.DefaultCredentials
reader.XmlResolver = resolver
' Parse the file.
while (reader.Read())
' Do any additional processing here.
end while
' Close the reader.
reader.Close()
end sub
end class
Comentários
Observação
A partir do .NET Framework 2.0, recomendamos que você crie XmlReader instâncias usando o XmlReader.Create método para aproveitar a nova funcionalidade.
O leitor usa XmlResolver para resolver o local do arquivo carregado no leitor e também para resolver referências DTD. Por exemplo, se o XML tiver incluído a declaração DOCTYPE, <!DOCTYPE book SYSTEM book.dtd> o leitor resolverá esse arquivo externo e garantirá que o DTD esteja bem formado. O leitor não usa o DTD para validação.
Essa propriedade pode ser alterada a qualquer momento e entra em vigor na próxima operação de leitura. Se essa propriedade estiver definida como null, quaisquer referências DTD externas encontradas pelo leitor não serão resolvidas.
Na versão 1.1 do .NET Framework, se essa propriedade não estiver definida, o nível de confiança do aplicativo determinará o comportamento padrão.
Fully trusted code: O leitor usa um padrão XmlUrlResolver sem credenciais de usuário. Se a autenticação for necessária para acessar um recurso de rede, use a XmlResolver propriedade para especificar uma XmlResolver com as credenciais necessárias.
Semi-trusted code: A XmlResolver propriedade está definida como null. Os recursos externos não são resolvidos.