XmlResolver.GetEntity(Uri, String, Type) Método

Definição

Espaço de Nomes:

System.Xml

Assemblagens:

netstandard.dll, System.Xml.ReaderWriter.dll

Origem:

XmlResolver.cs

Quando sobreposto numa classe derivada, mapeia um URI para um objeto que contém o recurso real.

public:
 abstract System::Object ^ GetEntity(Uri ^ absoluteUri, System::String ^ role, Type ^ ofObjectToReturn);

public abstract object? GetEntity(Uri absoluteUri, string? role, Type? ofObjectToReturn);

abstract member GetEntity : Uri * string * Type -> obj

Public MustOverride Function GetEntity (absoluteUri As Uri, role As String, ofObjectToReturn As Type) As Object

Parâmetros

absoluteUri

Uri

O URI retornou de ResolveUri(Uri, String).

role

String

Atualmente não utilizado.

ofObjectToReturn

Type

O tipo de objeto a devolver. A versão atual apenas devolve objetos System.IO.Stream.

Devoluções

Object

Um objeto de fluxo ou null se for especificado um tipo diferente de fluxo.

Exceções

XmlException

ofObjectToReturn não é um Stream tipo.

UriFormatException

O URI especificado não é um URI absoluto.

ArgumentNullException

absoluteUri é null.

Exception

Existe um erro em tempo de execução (por exemplo, uma ligação ao servidor interrompida).

Exemplos

Veja XmlUrlResolver.GetEntity um exemplo que utiliza este método.

Observações

Este método é usado quando o chamador quer mapear um dado URI para o objeto que contém o recurso real que o URI representa. O tipo de objeto devolvido é negociável; no entanto, a implementação deve sempre suportar System.IO.Stream.

Para a versão assíncrona deste método, veja GetEntityAsync.

Importante

Seu aplicativo pode mitigar ameaças de negação de serviço devido ao uso excessivo de memória ao método GetEntity ao implementar um IStream que limita o número de bytes lidos. Isso ajuda a proteger contra situações em que códigos mal-intencionados tentam passar um fluxo infinito de bytes para o GetEntity método.