XmlReaderSettings.XmlResolver Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mengatur yang XmlResolver digunakan untuk mengakses dokumen eksternal.
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.XmlResolverPublic Property XmlResolver As XmlResolverNilai Properti
Digunakan XmlResolver untuk mengakses dokumen eksternal. Jika diatur ke null, akan XmlException dilemparkan saat XmlReader mencoba mengakses sumber daya eksternal. Defaultnya adalah baru XmlUrlResolver tanpa kredensial. Dimulai dengan .NET Framework 4.5.2, pengaturan ini memiliki nilai nulldefault .
Contoh
Contoh berikut membuat XmlReader yang menggunakan XmlSecureResolver dengan kredensial default.
// Create an XmlSecureResolver with default credentials.
XmlSecureResolver myResolver = new XmlSecureResolver(new XmlUrlResolver(), "http://serverName/data/");
myResolver.Credentials = CredentialCache.DefaultCredentials;
XmlReaderSettings settings = new XmlReaderSettings();
settings.XmlResolver = myResolver;
// Create the reader.
XmlReader reader = XmlReader.Create("http://serverName/data/books.xml", settings);
' Create an XmlSecureResolver with default credentials.
Dim myResolver As New XmlSecureResolver(New XmlUrlResolver(), "http://serverName/data/")
myResolver.Credentials = CredentialCache.DefaultCredentials
Dim settings As New XmlReaderSettings()
settings.XmlResolver = myResolver
' Create the reader.
Dim reader As XmlReader = XmlReader.Create("http://serverName/data/books.xml", settings)
Keterangan
XmlResolver digunakan untuk menemukan dan membuka dokumen instans XML, atau untuk menemukan dan membuka sumber daya eksternal apa pun yang direferensikan oleh dokumen instans XML. Ini dapat mencakup entitas, DTD, atau skema. Properti XmlResolver.Credentials dapat digunakan untuk menentukan kredensial apa pun yang diperlukan untuk autentikasi jaringan.
Penting
XmlResolver Karena dapat berisi informasi sensitif seperti kredensial pengguna, Anda harus berhati-hati saat membuat XmlReaderSettings cache objek, atau saat meneruskan XmlReaderSettings objek dari satu komponen ke komponen lainnya.
Dapat XmlSecureResolver digunakan untuk mengakses dokumen eksternal. Kelas ini XmlSecureResolver membantu mengamankan implementasi XmlResolver lain dengan membungkus XmlResolver objek dan membatasi sumber daya yang XmlResolver mendasarnya memiliki akses.
Bendera validasi ProcessInlineSchema dan ProcessSchemaLocation dari objek XmlReaderSettings tidak diatur secara default. Ketika parameter ini diatur, XmlResolver dari objek XmlReaderSettings digunakan untuk menentukan lokasi skema yang ditemukan dalam dokumen instance pada XmlReader. Jika objek XmlResolver adalah null, lokasi skema tidak diselesaikan meskipun bendera validasi ProcessInlineSchema dan ProcessSchemaLocation diatur.
Skema yang ditambahkan selama validasi menambahkan jenis baru dan dapat mengubah hasil validasi dokumen yang sedang divalidasi. Akibatnya, skema eksternal hanya boleh diselesaikan dari sumber tepercaya.
