XmlResolver.GetEntity(Uri, String, Type) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Quando substituído em uma 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);public abstract object GetEntity(Uri absoluteUri, string role, Type ofObjectToReturn);abstract member GetEntity : Uri * string * Type -> objPublic MustOverride Function GetEntity (absoluteUri As Uri, role As String, ofObjectToReturn As Type) As ObjectParâmetros
- absoluteUri
- Uri
O URI retornado de ResolveUri(Uri, String).
- role
- String
Não usado no momento.
- ofObjectToReturn
- Type
O tipo de objeto a ser retornado. A versão atual retorna apenas objetos System.IO.Stream.
Retornos
Um objeto de fluxo ou null se um tipo diferente de fluxo for especificado.
Exceções
ofObjectToReturn não é um Stream tipo.
O URI especificado não é um URI absoluto.
absoluteUri é null.
Há um erro de runtime (por exemplo, uma conexão de servidor interrompida).
Exemplos
Consulte XmlUrlResolver.GetEntity um exemplo usando esse método.
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. O tipo de objeto retornado é negociável; no entanto, a implementação deve sempre dar suporte System.IO.Stream.
Para obter a versão assíncrona deste método, consulte GetEntityAsync.
Importante
Seu aplicativo pode mitigar as ameaças de negação de serviço à memória no método GetEntity implementando um IStream que limita o número de bytes lidos. Isso ajuda a proteger-se contra situações em que o código mal-intencionado tenta passar um fluxo infinito de bytes para o GetEntity método.
