XmlTextReader.XmlResolver Properti

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Sumber:

XmlTextReader.cs

Mengatur yang XmlResolver digunakan untuk menyelesaikan referensi 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

Nilai Properti

XmlResolver

XmlResolver yang digunakan. Jika diatur ke null, sumber daya eksternal tidak diselesaikan.

Dalam versi 1.1 dari .NET Framework, pemanggil harus sepenuhnya dipercaya untuk menentukan XmlResolver.

Contoh

Contoh berikut menggunakan XmlResolver properti untuk menentukan kredensial yang diperlukan untuk mengakses file berjaringan.

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

Keterangan

Note

Kami menyarankan Anda membuat instans XmlReader untuk memanfaatkan fungsionalitas baru dengan menggunakan metode XmlReader.Create.

Pembaca menggunakan XmlResolver untuk menyelesaikan lokasi file yang dimuat ke pembaca dan juga untuk menyelesaikan referensi DTD. Misalnya, jika XML Anda menyertakan deklarasi DOCTYPE, <!DOCTYPE book SYSTEM book.dtd> pembaca menyelesaikan file eksternal ini dan memastikan bahwa DTD terbentuk dengan baik. Pembaca tidak menggunakan DTD untuk validasi.

Properti ini dapat diubah kapan saja dan berlaku pada operasi baca berikutnya. Jika properti ini diatur ke null, referensi DTD eksternal apa pun yang ditemui oleh pembaca tidak diselesaikan.

Dalam versi 1.1 dari .NET Framework, jika properti ini tidak diatur, tingkat kepercayaan aplikasi menentukan perilaku default.

Fully trusted code: Pembaca menggunakan default XmlUrlResolver tanpa kredensial pengguna. Jika autentikasi diperlukan untuk mengakses sumber daya jaringan, gunakan XmlResolver properti untuk menentukan dengan kredensial yang XmlResolver diperlukan.

Semi-trusted code: Properti XmlResolver diatur ke null. Sumber daya eksternal tidak diselesaikan.

Lihat juga

• Credentials
• CredentialCache
• NetworkCredential
• XmlReader