XmlUrlResolver Sınıf

Tanım

public ref class XmlUrlResolver : System::Xml::XmlResolver

public class XmlUrlResolver : System.Xml.XmlResolver

type XmlUrlResolver = class
    inherit XmlResolver

Public Class XmlUrlResolver
Inherits XmlResolver

Devralma

Object

XmlResolver

XmlUrlResolver

Örnekler

Aşağıdaki örnek, varsayılan kimlik bilgilerine sahip bir XmlUrlResolver kullanan bir XmlReader oluşturur.

// Create an XmlUrlResolver with default credentials.
XmlUrlResolver resolver = new XmlUrlResolver();
resolver.Credentials = CredentialCache.DefaultCredentials;

// Create the reader.
XmlReaderSettings settings = new XmlReaderSettings();
settings.XmlResolver = resolver;
XmlReader reader =
     XmlReader.Create("http://serverName/data/books.xml", settings);

' Create an XmlUrlResolver with default credentials.
Dim resolver As New XmlUrlResolver()
resolver.Credentials = CredentialCache.DefaultCredentials

' Create the reader.
Dim settings As New XmlReaderSettings()
settings.XmlResolver = resolver
Dim reader As XmlReader = _
   XmlReader.Create("http://serverName/data/books.xml", settings)

Açıklamalar

XmlUrlResolver varlıklar, belge türü tanımları (DTD' ler) veya şemalar gibi dış XML kaynaklarını çözümlemek için kullanılır. Genişletilebilir Stil Sayfası Dili (XSL) stil sayfalarında veya XML Şeması tanım dili (XSD) şemalarında bulunan öğeleri dahil etmek ve içeri aktarmak için de kullanılır.

XmlUrlResolver, System.Xml ad alanında tüm sınıflar için varsayılan çözümleyicidir. WebRequest sınıfından file:// ve http:// protokollerini ve isteklerini destekler.

DTD'leri Çözümleme

Bir XML okuyucusu (XmlReader) dış DTD içeren bir XML dosyasını okuyorsa, DTD'nin akış gösterimini almak için XmlUrlResolver.GetEntityAsync yöntemini çağırır. DTD'nin URI'si göreli bir URI ise, XML okuyucusu XmlUrlResolver.ResolveUri yöntemini çağırır ve verilen relativeUri ve baseURi parametreleri için mutlak bir URI döndürür. XmlUrlResolver URI'nin nasıl çözümleneceğini bilmiyorsa nulldöndürür.

XmlUrlResolver.GetEntity yöntemi, kaynağa erişim kazanmak için Credentials özelliğindeki bilgileri uygun şekilde kullanır. Güvenlik nedeniyle bu özelliğin get erişimcisi yoktur. XmlResolverüzerine yazılırken GetEntity, Credentials özelliğindeki kimlik bilgisi bilgilerini kullanan yöntemdir.

Diğer tüm XML kaynaklarını çözümlemek, DTD'leri çözümlemeye çok benzer. XmlResolver dış kaynakla bağlantı oluşturur ve içeriğin Stream bir gösterimini döndürür. XmlResolver çağrısı yapan nesne akışı yorumlar.

XmlUrlResolver sınıfını genişletme

XmlUrlResolver sınıfının varsayılan davranışı, bir XML veri kaynağını önbellekten değil kaynağından çözümlemektir. Bazı durumlarda, bir veri kaynağını önbellekten çözümlemek, veri kaynağının sunucusuna bir gezi kaydederek uygulamanın performansını artırabilir. Buradaki performans kazançları, up-totarih içeriğine olan ihtiyaçlara karşı tartılmalıdır.

Aşağıdaki örnek, önbellekten kaynak almak için XmlUrlResolver genişletir ve XmlCachingResolveryeni bir sınıf oluşturur. Bu, XmlUrlResolver.Credentials özelliği ve XmlUrlResolver.GetEntity yöntemi geçersiz kılınarak yapılır.

class XmlCachingResolver : XmlUrlResolver
{
    bool enableHttpCaching;
    ICredentials credentials;

    //resolve resources from cache (if possible) when enableHttpCaching is set to true
    //resolve resources from source when enableHttpcaching is set to false
    public XmlCachingResolver(bool enableHttpCaching)
    {
        this.enableHttpCaching = enableHttpCaching;
    }

    public override ICredentials Credentials
    {
        set
        {
            credentials = value;
            base.Credentials = value;
        }
    }

    public override object GetEntity(Uri absoluteUri, string role, Type ofObjectToReturn)
    {
        if (absoluteUri == null)
        {
            throw new ArgumentNullException("absoluteUri");
        }
        //resolve resources from cache (if possible)
        if (absoluteUri.Scheme == "http" && enableHttpCaching && (ofObjectToReturn == null || ofObjectToReturn == typeof(Stream)))
        {
            WebRequest webReq = WebRequest.Create(absoluteUri);
            webReq.CachePolicy = new HttpRequestCachePolicy(HttpRequestCacheLevel.Default);
            if (credentials != null)
            {
                webReq.Credentials = credentials;
            }
            WebResponse resp = webReq.GetResponse();
            return resp.GetResponseStream();
        }
        //otherwise use the default behavior of the XmlUrlResolver class (resolve resources from source)
        else
        {
            return base.GetEntity(absoluteUri, role, ofObjectToReturn);
        }
    }
}

Class XmlCachingResolver
    Inherits XmlUrlResolver
    Dim enableHttpCaching As Boolean
    Public Shadows Credentials As ICredentials

    'resolve resources from cache (if possible) when enableHttpCaching is set to true
    'resolve resources from source when enableHttpcaching is set to false
    Public Sub New(ByVal enableHttpCaching As Boolean)
        Me.enableHttpCaching = enableHttpCaching
    End Sub

    Public Shadows Function GetEntity(ByVal absoluteUri As Uri, ByVal role As String, ByVal returnType As Type) As Object
        If absoluteUri = Nothing Then
            Throw New ArgumentNullException("absoluteUri")
        End If

        'resolve resources from cache (if possible)
        If absoluteUri.Scheme = "http" And enableHttpCaching And (returnType Is GetType(Nullable) Or returnType Is GetType(Stream)) Then
            Dim webReq As WebRequest = WebRequest.Create(absoluteUri)
            webReq.CachePolicy = New HttpRequestCachePolicy(HttpRequestCacheLevel.Default)
            If Not (Credentials Is Nothing) Then
                webReq.Credentials = Credentials
            End If
            Dim resp As WebResponse = webReq.GetResponse()
            Return resp.GetResponseStream()
            'otherwise use the default behavior of the XmlUrlResolver class (resolve resources from source)
        Else
            Return MyBase.GetEntity(absoluteUri, role, returnType)
        End If

    End Function
End Class

XmlCachingResolver sınıfının önbelleğe alma davranışı GetEntity yönteminde uygulanır. Bu, yeni WebRequest ve HttpRequestCachePolicy nesneleri oluşturularak yapılır. HttpRequestCachePolicy nesnesi, HttpRequestCacheLevel numaralandırmasının Default üyesi kullanılarak oluşturulur.

WebRequest nesnesinin CachePolicy özelliği HttpRequestCachePolicy nesnesiyle ayarlanır.

XmlCachingResolver sınıfının bir örneği BooleanenableHttpCachingile oluşturulur. Bu değer trueolarak ayarlandığında, örnek mümkünse varsayılan önbellekten bir kaynağı çözümler. enableHttpCaching falseolarak ayarlandığında, örnek varsayılan davranışı kullanır ve kaynaklarından kaynakları çözümler.

Oluşturucular

Özellikler

Yöntemler

Şunlara uygulanır

Ayrıca bkz.

• XML Belgeleri ve Veri