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

Definição

Namespace:

System.Xml.Resolvers

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Mapeia um URI para um objeto que contém o recurso real.

public:
 override System::Object ^ GetEntity(Uri ^ absoluteUri, System::String ^ role, Type ^ ofObjectToReturn);

public override object? GetEntity (Uri absoluteUri, string? role, Type? ofObjectToReturn);

public override object GetEntity (Uri absoluteUri, string role, Type ofObjectToReturn);

override this.GetEntity : Uri * string * Type -> obj

Public Overrides 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

A versão atual do .NET Framework para Silverlight não usa esse parâmetro durante a resolução de URIs. Esse parâmetro é fornecido para fins de extensibilidade futura. Por exemplo, esse parâmetro pode ser mapeado para o xlink:role e usado como um argumento específico de implementação em outros cenários.

ofObjectToReturn

Type

O tipo de objeto a ser retornado. O XmlPreloadedResolver dá suporte a objetos Stream e a objetos TextReader para URIs que foram adicionados como String. Se o tipo solicitado não tiver suporte no resolvedor, uma exceção será gerada. Use o método SupportsType(Uri, Type) para determinar se um certo Type tem suporte nesse resolvedor.

Retornos

Object

Um objeto Stream ou TextReader que corresponde à fonte atual.

Exceções

ArgumentNullException

absoluteUri é null.

XmlException

Não é possível resolver o URI passado em absoluteUri.

- ou - ofObjectToReturn não é de um tipo com suporte.

Comentários

O XmlPreloadedResolver primeiro tentará pesquisar o recurso em seu repositório de dados pré-carregados. Se não conseguir encontrá-lo, ele chamará o método do resolvedor de GetEntity fallback. Se nenhum resolvedor de fallback tiver sido fornecido no XmlPreloadedResolver construtor, uma exceção será gerada.