Dış Kaynakları Çözme

XmlDocument'ın XmlResolver özelliği, XmlDocument sınıfı tarafından dış belge türü tanımları (DTD'ler), varlıklar ve şemalar gibi XML verilerinde satır içi olmayan kaynakları bulmak için kullanılır. Bu öğeler bir ağda veya yerel sürücüde bulunabilir ve Tekdüzen Kaynak Tanımlayıcısı (URI) ile tanımlanabilir. Bu, XmlDocument'ın belgede bulunan EntityReference düğümlerini çözümlemesine ve belgeyi dış DTD veya şemaya göre doğrulamasına olanak tanır.

Tam Güvenilir Xml Belgeleri

XmlResolver özelliği XmlDocument.Load yönteminin işlevselliğini etkiler. Aşağıdaki tabloda, XmlDocument nesnesine tam olarak güvenildiğinde XmlDocument.XmlResolver özelliğinin nasıl çalıştığı gösterilmektedir. Aşağıdaki tabloda, Load'a giriş bir TextReader, String, Stream veya URI olduğunda XmlDocument.Load yöntemleri gösterilmektedir. XmlDocument bir XmlReader'dan yüklendiyse bu tablo Load yöntemi için geçerli değildir.

XmlResolver özelliği	İşlev	Notlar
özelliği, daha önce oluşturulmuş ve kullanıcı tarafından önceden ayarlanmış özelliklere sahip bir XmlResolver sınıfına ayarlanır.	XmlDocument, DTD'ler, varlıklar ve şemalar gibi dış kaynaklara yapılan başvuruları çözümlemek için dosya adlarını çözümlemek için verilen XmlResolver'ı kullanır. XmlResolver, XmlDocument'a düğüm eklerken veya düzenlerken gereken dış kaynaklar çözümlenirken de kullanılır.	XmlDocument'a verilen XmlResolver, dış kaynakların bulunması ve çözülmesi gerektiğinde kullanılan çözümleyicidir.
özelliği null (Microsoft Visual Basic .NET'te hiçbir şey) olarak ayarlanır.	Dış şemayı veya DTD'yi bulma gibi dış kaynak gerektiren özellikler desteklenmez. Dış varlıklar da çözümlenmez ve çözümleme gerektiren varlık düğümleri ekleme gibi düzenleme işlevlerinin gerçekleştirilmesi desteklenmez.	XmlDocument dosyaları anonim olarak yükler ve diğer kaynakları çözümlemeye çalışmaz.
Özelliği ayarlanmadı, ancak varsayılan durumunda bırakıldı.	XmlUrlResolver null kimlik bilgileriyle başlatılacak ve dosya adlarını çözümlerken, dış DTD'leri, varlıkları ve şemaları bulurken ve düğümleri düzenlerken XmlDocument tarafından kullanılacaktır; bu işlemler sırasında null kimlik bilgileri kullanılacaktır.

Aşağıdaki tabloda, XmlReader yükleme girişi olduğunda ve XmlDocument tam yetkili olduğunda XmlDocument.Load yöntemi gösterilmektedir.

XmlResolver özelliği	İşlev	Notlar
XmlDocument tarafından kullanılan XmlResolver sınıfı, XmlReader tarafından kullanılan sınıfla aynıdır.	XmlDocument, XmlReader'a atanan XmlResolver'ı kullanır. XmlDocument.Resolver özelliği, XmlDocument güven düzeyi ne olursa olsunXmlReader'dan bir XmlResolver aldığı için ayarlanamaz. XmlDocument'ın XmlResolver özelliğini ayarlayarak XmlReaders'ın XmlResolver ayarlarını geçersiz kılmayı deneyemezsiniz.	XmlReader, XmlTextReader, XmlValidatingReader veya özel yazılmış bir okuyucu olabilir. Kullanılan okuyucu varlık çözümlemesini destekliyorsa dış varlıklar çözümlenir. Geçirilen okuyucu varlık başvurularını desteklemiyorsa varlık başvuruları çözümlenmez.

Yarı Güvenilir XmlDocument

Aşağıdaki tabloda, nesne yarı güvenilir olduğunda XmlDocument.XmlResolver özelliğinin nasıl çalıştığı gösterilmektedir. Bu tablo, XmlDocument.Load yöntemleri için, giriş Load'a bir TextReader, String, Stream veya URI olduğunda geçerlidir. XmlDocument bir XmlReader'dan yüklendiyse bu tablo Load yöntemi için geçerli değildir.

XmlResolver özelliği	İşlev	Notlar
Yarı güvenilir senaryoda XmlResolver özelliği null dışında bir değere ayarlanamaz.	null kimlik bilgilerine sahip bir XmlUrlResolver örneği, dosya adları çözümlenirken, dış DTD'ler, varlıklar ve şemalar aranırken XmlDocument tarafından oluşturulacak ve kullanılacaktır; düğümler düzenlenirken de null kimlik bilgileri kullanılacaktır.	Bu davranış, XmlResolver özelliği ayarlanmadığında ancak varsayılan durumunda bırakıldığındaki davranışla aynıdır. XmlDocument tüm eylemler için anonim izinler kullanır.
özelliği null (Microsoft Visual Basic .NET'te hiçbir şey) olarak ayarlanır.	Dış şemayı veya DTD'yi bulma gibi dış kaynak gerektiren hiçbir özellik desteklenmez. Dış varlıklar da çözümlenmez ve çözüm gerektiren varlık düğümleri ekleme gibi düzenleme işlevlerinin gerçekleştirilmesi desteklenmez.	Özellik null olduğunda, XmlDocument tam olarak güvenilir veya yarı güvenilir olmasına bakılmaksızın davranış aynıdır.
Özelliği ayarlanmadı, ancak varsayılan durumunda bırakıldı.	Null kimlik bilgilerine sahip bir XmlUrlResolver örneği oluşturulacak ve XmlDocument tarafından dosya adları çözümlenirken, dış DTD'ler, varlıklar ve şemalar bulunurken kullanılacaktır. Ayrıca, düğümler düzenlenirken de null kimlik bilgileri kullanılacaktır.	XmlDocument tüm eylemler için anonim izinler kullanır.

Bu tablo, Load girişinin bir XmlReader olduğu ve XmlDocument'in yarı güvenilir olduğu durumlarda XmlDocument.Load yöntemi için geçerlidir.

XmlResolver özelliği	İşlev	Notlar
XmlDocument tarafından kullanılan XmlResolver sınıfı, XmlReader tarafından kullanılan sınıfla aynıdır.	XmlDocument, XmlReader'a atanan XmlResolver'ı kullanır. XmlDocument.Resolver özelliği, XmlDocument güven düzeyi ne olursa olsun ayarlanamaz, çünkü XmlReader'dan bir XmlResolver almaktadır. XmlDocument'ın XmlResolver özelliğini ayarlayarak XmlReaders XmlResolver ayarlarını geçersiz kılmayı deneyemezsiniz.	XmlReader, XmlTextReader, XmlReader doğrulayan bir okuyucu veya özel yazılmış bir okuyucu olabilir. Kullanılan okuyucu varlık çözümlemesini destekliyorsa dış varlıklar çözümlenir. Eğer iletilen okuyucu varlık referanslarını desteklemiyorsa, bu varlık referansları çözümlenmez.

XmlResolver'ın doğru kimlik bilgilerini içerecek şekilde ayarlanması dış kaynaklara erişime izin verir.

Not

XmlResolver özelliğini alma yolu yoktur. Bu, kullanıcının kimlik bilgilerinin ayarlandığı XmlResolver'ı yeniden kullanmasını önlemeye yardımcı olur. Ayrıca, XmlDocument'ı yüklemek için bir XmlTextReader veya doğrulama XmlReader kullanılırsa ve XmlDocument ayarlanmış bir çözümleyiciye sahipse, bu okuyucuların çözümleyicileri Yükleme aşamasından sonra XmlDocument tarafından önbelleğe alınmaz, çünkü bu da bir güvenlik riski oluşturur.

Daha fazla bilgi için başvuru sayfasının Açıklamalar bölümüne XmlResolver bakın.

Ayrıca bkz.

• XML Belge Nesne Modeli (DOM)