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

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