XmlReaderSettings.XmlResolver Özellik

Tanım

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; }
public System.Xml.XmlResolver XmlResolver { set; }
member this.XmlResolver : System.Xml.XmlResolver
Public Property XmlResolver As XmlResolver

Özellik Değeri

XmlResolver

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

Örnekler

Aşağıdaki örnek, varsayılan kimlik bilgileriyle kullanan bir XmlReader XmlSecureResolver 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 bulmak ve 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 XmlReaderSettings alırken 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 XmlResolver erişimi olan kaynakları kısıtlayarak uygulamasının başka bir uygulamasının XmlResolver güvenliğini sağlar.

Bir XmlReaderSettings nesnenin ProcessInlineSchema ve ProcessSchemaLocation doğrulama bayrakları varsayılan olarak ayarlanmaz. Bu bayraklar ayarlandığında, XmlResolver nesnesinin XmlReaderSettings nesnesi içindeki örnek belgesinde XmlReaderkarşılaşılan şema konumlarını çözümlemek için kullanılır. XmlResolver nesnesi ise nullve ProcessSchemaLocation doğrulama bayrakları ayarlanmış olsa ProcessInlineSchema 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.

Şunlara uygulanır

Ayrıca bkz.