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

Definição

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

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

role

String

Não usado no momento.

ofObjectToReturn

Type

O tipo de objeto a ser retornado. A versão atual retorna somente objetos System.IO.Stream.

Retornos

Object

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

Exceções

XmlException

ofObjectToReturn não é um tipo Stream.

UriFormatException

O URI especificado não é um URI absoluto.

ArgumentNullException

absoluteUri é null.

Exception

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 reduzir a negação de memória de ameaças de serviço ao GetEntity método implementando um IStream que limita o número de bytes lidos. 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.