XmlUrlResolver Sınıf

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kod:

System.Xml.ReaderWriter.dll

Kaynak:

XmlUrlResolver.cs

Tekdüzen Kaynak Tanımlayıcısı (URI) tarafından adlandırılan dış XML kaynaklarını çözümler.

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.

Önemli

XmlUrlResolver nesneler, kullanıcı kimlik bilgileri gibi hassas bilgiler içerebilir. XmlUrlResolver nesneleri önbelleğe alırken dikkatli olmanız ve XmlUrlResolver nesneleri güvenilmeyen bir bileşene geçirmemelisiniz.

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.

Not

Bu örnek, .NET Framework'teki XML sınıflarının genişletilebilirliklerinden yararlanıyor. Diğer sınıflar, belirli bir uygulamanın gereksinimlerine uyacak şekilde genişletilebilir ve özelleştirilebilir.

Oluşturucular

XmlUrlResolver()

XmlUrlResolver sınıfının yeni bir örneğini başlatır.

Özellikler

CachePolicy	Temel alınan WebRequest nesnesi için önbellek ilkesini alır veya ayarlar.
Credentials	Web isteklerinin kimliğini doğrulamak için kullanılan kimlik bilgilerini ayarlar.
Proxy	Temel alınan WebRequest nesnesi için ağ proxy'sini alır veya ayarlar.

Yöntemler

Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetEntity(Uri, String, Type)	URI'yi gerçek kaynağı içeren bir nesneyle eşler.
GetEntityAsync(Uri, String, Type)	Bir URI'yi zaman uyumsuz olarak gerçek kaynağı içeren bir nesneye eşler.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
ResolveUri(Uri, String)	Temel ve göreli URI'lerden mutlak URI'yi çözümler.
SupportsType(Uri, Type)	Çözümleyicinin Streamdışındaki türleri döndürmesini sağlar. (Devralındığı yer: XmlResolver)
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)

Ayrıca bkz.

• XML Belgeleri ve Veri