XmlReaderSettings.XmlResolver Özellik

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Xml.ReaderWriter.dll

Kaynak:

XmlReaderSettings.cs

Dış belgelere erişmek için kullanılan öğesini XmlResolver ayarlar.

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

Özellik Değeri

XmlResolver

XmlResolver Dış belgelere erişmek için kullanılan. olarak ayarlanırsa null, XmlException dış kaynağa erişmeye çalıştığında bir oluşturulur XmlReader . Varsayılan değer, kimlik bilgisi olmayan yeni XmlUrlResolver bir değerdir. .NET Framework 4.5.2'den başlayarak, bu ayarın varsayılan değeri vardır null.

Örnekler

Aşağıdaki örnek, varsayılan kimlik bilgileriyle kullanan bir XmlReaderXmlSecureResolver oluşturur.

// 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)

Açıklamalar

XmlResolver, bir XML örneği belgesini bulup açmak veya XML örneği belgesi tarafından başvuruda bulunup başvuruda bulunan dış kaynakları açmak için kullanılır. Bu varlıklar, DTD veya şemaları içerebilir. XmlResolver.Credentials özelliği, ağ kimlik doğrulaması için gereken kimlik bilgilerini belirtmek için kullanılabilir.

Önemli

XmlResolver kullanıcı kimlik bilgileri gibi hassas bilgiler içerebileceğinden, nesneleri önbelleğe alırken XmlReaderSettings veya nesneyi bir bileşenden diğerine geçirirken XmlReaderSettings dikkatli olmanız gerekir.

dış XmlSecureResolver belgelere erişmek için kullanılabilir. sınıfı, XmlSecureResolver nesnesini sarmalayarak XmlResolver ve temel alınanın XmlResolver erişimi olan kaynakları kısıtlayarak uygulamasının başka bir uygulamasının XmlResolver güvenliğini sağlamaya yardımcı olur.

Bir ProcessInlineSchema nesnenin ProcessSchemaLocation ve XmlReaderSettings doğrulama bayrakları varsayılan olarak ayarlanmaz. Bu bayraklar ayarlandığında, XmlResolver nesnesi, XmlReaderSettings öğesindeki örnek belgede XmlReader karşılaşılan şema konumlarını çözümlemek için kullanılır. XmlResolver nesnesi null ise, ProcessInlineSchema ve ProcessSchemaLocation doğrulama bayrakları ayarlansa bile şema konumları çözümlenmez.

Doğrulama sırasında eklenen şemalar yeni türler ekler ve doğrulanan belgenin doğrulama sonucunu değiştirebilir. Sonuç olarak dış şemalar yalnızca güvenilir kaynaklardan çözümlenmelidir.

Ayrıca bkz.

• XmlReader
• Create(String)