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

  • Referência

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.

Aplica-se a