Partilhar via


XmlTextReader.XmlResolver Propriedade

Definição

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

XmlResolver

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.

Aplica-se a

Confira também