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

Definição

Espaço de Nomes:

System.Xml

Assemblagem:

System.Xml.dll

Mapeia um URI para um objeto que contém o recurso real. Este método define temporariamente o PermissionSet criado no construtor ao chamar PermitOnly() antes de chamar GetEntity o subjacente XmlResolver para abrir o recurso.

public:
 override System::Object ^ GetEntity(Uri ^ absoluteUri, System::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 que é devolvido de ResolveUri(Uri, String).

role

String

Atualmente não utilizado.

ofObjectToReturn

Type

O tipo de objeto a devolver. A versão atual apenas devolve Stream objetos.

Devoluções

Object

O fluxo retornou ao invocar GetEntity o subjacente XmlResolver. Se um tipo diferente de Stream for especificado, o método devolve null.

Exceções

XmlException

ofObjectToReturn não é nem null um Stream tipo.

-ou-

.NET 7 e versões posteriores: Em todos os casos.

UriFormatException

O URI especificado não é um URI absoluto.

NullReferenceException

absoluteUri é null.

Exception

Existe um erro em tempo de execução (por exemplo, uma ligação ao servidor interrompida).

Observações

Importante

Seu aplicativo pode mitigar ameaças de negação de serviço devido ao uso excessivo de memória ao método GetEntity ao implementar um IStream que limita o número de bytes lidos. Isso ajuda a proteger contra situações em que códigos mal-intencionados tentam passar um fluxo infinito de bytes para o GetEntity método.