XmlUrlResolver Classe

Definição

Namespace:

System.Xml

Assemblies:

netstandard.dll, System.Xml.ReaderWriter.dll

Origem:

XmlUrlResolver.cs

Resolve recursos XML externos nomeados por um URI (Uniform Resource Identifier).

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

public class XmlUrlResolver : System.Xml.XmlResolver

type XmlUrlResolver = class
    inherit XmlResolver

Public Class XmlUrlResolver
Inherits XmlResolver

Herança

Object

XmlResolver

XmlUrlResolver

Exemplos

O exemplo a seguir cria um XmlReader que usa uma XmlUrlResolver credenciais com padrão.

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

Comentários

XmlUrlResolver é usado para resolver recursos XML externos, como entidades, DTDs (definições de tipo de documento) ou esquemas. Ele também é usado para processar elementos de inclusão e importação encontrados em folhas de estilo XSL (Extensible StyleSheet Language) ou esquemas XSD (linguagem de definição de esquema XML).

XmlUrlResolver é o resolvedor padrão para todas as classes no System.Xml namespace. Ele dá suporte aos file:// protocolos e http:// solicitações da WebRequest classe.

Importante

XmlUrlResolver os objetos podem conter informações confidenciais, como credenciais de usuário. Você deve ter cuidado ao armazenar objetos em cache XmlUrlResolver e não deve passar XmlUrlResolver objetos para um componente não confiável.

Resolvendo DTDs

Se um leitor XML (XmlReader) estiver lendo um arquivo XML que contém um DTD externo, ele chamará o XmlUrlResolver.GetEntityAsync método para obter uma representação de fluxo do DTD. Se o URI do DTD for um URI relativo, o leitor XML chamará o XmlUrlResolver.ResolveUri método e retornará um URI absoluto para os parâmetros e baseURi fornecidosrelativeUri. Se o XmlUrlResolver URI não souber como resolver, ele retornará null.

O XmlUrlResolver.GetEntity método usa as informações na Credentials propriedade conforme apropriado para obter acesso ao recurso. Não há acessador get para essa propriedade por motivos de segurança. Ao substituir XmlResolver, GetEntity é o método que utiliza as informações de credencial na propriedade Credentials .

Resolver todos os outros recursos XML é muito semelhante à resolução de DTDs. XmlResolver negocia a conexão com o recurso externo e retorna uma Stream representação do conteúdo. O objeto que está fazendo a chamada para XmlResolver interpretar o fluxo.

Estendendo a classe XmlUrlResolver

O comportamento padrão da XmlUrlResolver classe é resolver um recurso de dados XML de sua origem, não do cache. Em alguns casos, resolver um recurso de dados do cache pode melhorar o desempenho de um aplicativo salvando uma viagem ao servidor do recurso de dados. Os ganhos de desempenho aqui devem ser ponderados em relação à necessidade de conteúdo de data up-to.

O exemplo a seguir estende XmlUrlResolver e cria uma nova classe XmlCachingResolver, para recuperar recursos do cache. Isso é feito substituindo a XmlUrlResolver.Credentials propriedade e o XmlUrlResolver.GetEntity método.

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

O comportamento de cache da XmlCachingResolver classe é implementado no GetEntity método. Isso é feito criando objetos e HttpRequestCachePolicy novosWebRequest. O HttpRequestCachePolicy objeto é criado usando o Default membro da HttpRequestCacheLevel enumeração.

A CachePolicy propriedade do WebRequest objeto é definida com o HttpRequestCachePolicy objeto.

Uma instância da XmlCachingResolver classe é criada com o BooleanenableHttpCaching. Quando esse valor é definido como true, a instância resolve um recurso do cache padrão, se possível. Quando enableHttpCaching é definida como false, a instância usa o comportamento padrão e resolve recursos de sua origem.

Nota

Este exemplo aproveita a extensibilidade das classes XML no .NET Framework. Outras classes podem ser estendidas e personalizadas para atender às necessidades de um aplicativo específico.

Construtores

Nome	Description
XmlUrlResolver()	Inicializa uma nova instância da classe XmlUrlResolver.

Propriedades

Nome	Description
CachePolicy	Obtém ou define a política de cache para o objeto subjacente WebRequest .
Credentials	Define as credenciais usadas para autenticar solicitações da Web.
Proxy	Obtém ou define o proxy de rede para o objeto subjacente WebRequest .

Métodos

Nome	Description
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetEntity(Uri, String, Type)	Mapeia um URI para um objeto que contém o recurso real.
GetEntityAsync(Uri, String, Type)	Mapeia de forma assíncrona um URI para um objeto que contém o recurso real.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
ResolveUri(Uri, String)	Resolve o URI absoluto das URIs base e relativas.
SupportsType(Uri, Type)	Permite que o resolvedor retorne tipos diferentes de Stream. (Herdado de XmlResolver)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• Documentos e dados XML