XmlTextReader.XmlResolver Свойство

Определение

Пространство имен:

System.Xml

Сборки:

netstandard.dll, System.Xml.ReaderWriter.dll

Исходный код:

XmlTextReader.cs

Задает используемый XmlResolver для разрешения ссылок DTD.

public:
 property System::Xml::XmlResolver ^ XmlResolver {  void set(System::Xml::XmlResolver ^ value); };

public System.Xml.XmlResolver? XmlResolver { set; }

member this.XmlResolver : System.Xml.XmlResolver

Public Property XmlResolver As XmlResolver

Значение свойства

XmlResolver

Используется XmlResolver . Если задано значение null, внешние ресурсы не разрешаются.

В версии 1.1 .NET Framework вызывающий объект должен быть полностью доверенным, чтобы указать XmlResolver.

Примеры

В следующем примере свойство используется XmlResolver для указания учетных данных, необходимых для доступа к сетевому файлу.

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

Комментарии

Note

Рекомендуем создавать XmlReader экземпляры с помощью XmlReader.Create метода, чтобы воспользоваться новыми функциями.

Средство чтения используется XmlResolver для разрешения расположения файла, загруженного в средство чтения, а также для разрешения ссылок DTD. Например, если XML-код включал объявление DOCTYPE, <!DOCTYPE book SYSTEM book.dtd> средство чтения разрешает этот внешний файл и гарантирует, что DTD хорошо сформирован. Средство чтения не использует DTD для проверки.

Это свойство можно изменить в любое время и вступает в силу при следующей операции чтения. Если для этого свойства задано nullзначение, все внешние ссылки DTD, возникающие средством чтения, не разрешаются.

В версии 1.1 платформы .NET Framework, если это свойство не задано, уровень доверия приложения определяет поведение по умолчанию.

Fully trusted code: Средство чтения использует значение по умолчанию XmlUrlResolver без учетных данных пользователя. Если для доступа к сетевому ресурсу требуется проверка подлинности, используйте XmlResolver свойство, чтобы указать XmlResolver необходимые учетные данные.

Semi-trusted code: Для XmlResolver свойства задано значение null. Внешние ресурсы не разрешаются.

См. также раздел

• Credentials
• CredentialCache
• NetworkCredential
• XmlSecureResolver
• XmlReader