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

Definição

Quando substituído em uma classe derivada, mapeia um URI para um objeto que contém o recurso real.When overridden in a derived class, maps a URI to an object that contains the actual resource.

public:
 abstract System::Object ^ GetEntity(Uri ^ absoluteUri, System::String ^ role, Type ^ ofObjectToReturn);
public abstract object? GetEntity (Uri absoluteUri, 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 retornado de ResolveUri(Uri, String).The URI returned from ResolveUri(Uri, String).

role
String

Não usado no momento.Currently not used.

ofObjectToReturn
Type

O tipo de objeto a ser retornado.The type of object to return. A versão atual retorna somente objetos System.IO.Stream.The current version only returns System.IO.Stream objects.

Retornos

Object

Um objeto de fluxo ou null se for especificado um tipo diferente de fluxo.A stream object or null if a type other than stream is specified.

Exceções

ofObjectToReturn não é um tipo Stream.ofObjectToReturn is not a Stream type.

O URI especificado não é um URI absoluto.The specified URI is not an absolute URI.

absoluteUri é null.absoluteUri is null.

Há um erro de runtime (por exemplo, uma conexão de servidor interrompida).There is a runtime error (for example, an interrupted server connection).

Exemplos

Consulte XmlUrlResolver.GetEntity para obter um exemplo usando esse método.See XmlUrlResolver.GetEntity for an example using this method.

Comentários

Esse método é usado quando o chamador deseja mapear um determinado URI para o objeto que contém o recurso real que o URI representa.This method is used when the caller wants to map a given URI into the object containing the actual resource that the URI represents. O tipo de objeto retornado é negociável; no entanto, a implementação sempre deve dar suporte ao System.IO.Stream .The type of object returned is negotiable; however, the implementation must always support System.IO.Stream.

Para obter a versão assíncrona desse método, consulte GetEntityAsync .For the asynchronous version of this method, see GetEntityAsync.

Importante

Seu aplicativo pode atenuar as ameaças de negação de serviço de memória para o GetEntity método implementando um IStream que limita o número de bytes lidos.Your application can mitigate memory denial of service threats to the GetEntity method by implementing an IStream that limits the number of bytes read. Isso ajuda a proteger contra situações em que o código mal-intencionado tenta passar um fluxo infinito de bytes para o GetEntity método.This helps guard against situations where malicious code attempts to pass an infinite stream of bytes to the GetEntity method.

Aplica-se a