XmlTextReader.XmlResolver Propriedade

Definição

Espaço de Nomes:
System.Xml
Assemblagens:
netstandard.dll, System.Xml.ReaderWriter.dll
Assemblagem:
System.Xml.ReaderWriter.dll
Assemblagem:
System.Xml.dll
Assemblagem:
netstandard.dll
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs
Origem:
XmlTextReader.cs

Define os XmlResolver usados para resolver referências 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 de Propriedade

XmlResolver

O XmlResolver para usar. Se definido para null, os recursos externos não são resolvidos.

Na versão 1.1 do Framework .NET, o chamador deve ser totalmente confiável para especificar um XmlResolver.

Exemplos

O exemplo seguinte utiliza a XmlResolver propriedade para especificar as credenciais necessárias para aceder ao ficheiro em rede.

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

Observações

Note

Recomendamos que crie instâncias XmlReader usando o método XmlReader.Create para aproveitar a nova funcionalidade.

O leitor é usado XmlResolver para resolver a localização do ficheiro carregado no leitor e também para resolver referências DTD. Por exemplo, se o seu XML incluiu a declaração DOCTYPE, <!DOCTYPE book SYSTEM book.dtd> o leitor resolve este ficheiro externo e garante que o DTD está bem formado. O leitor não utiliza o DTD para validação.

Esta propriedade pode ser alterada a qualquer momento e entra em vigor na próxima operação de leitura. Se esta propriedade for definida para null, quaisquer referências DTD externas encontradas pelo leitor não são resolvidas.

Na versão 1.1 do .NET Framework, se esta propriedade não estiver definida, o nível de confiança da aplicação determina o comportamento padrão.

Fully trusted code: O leitor usa um padrão XmlUrlResolver sem credenciais de utilizador. Se for necessária autenticação para aceder a um recurso de rede, use a XmlResolver propriedade para especificar um 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

Ver também