Compartir vía


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

Definición

Cuando se invalida en una clase derivada, asigna un identificador URI a un objeto que contiene el 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

URI devuelto desde ResolveUri(Uri, String).

role
String

No se usa actualmente.

ofObjectToReturn
Type

Tipo de objeto que se va a devolver. La versión actual solo devuelve objetos System.IO.Stream.

Devoluciones

Objeto de flujo o null si se especifica un tipo que no sea un flujo.

Excepciones

ofObjectToReturn no es un tipo de Stream.

El identificador URI especificado no es un identificador URI absoluto.

absoluteUri es null.

Se ha producido un error en tiempo de ejecución (por ejemplo, una interrupción en la conexión con el servidor).

Ejemplos

Vea XmlUrlResolver.GetEntity para obtener un ejemplo con este método.

Comentarios

Este método se usa cuando el autor de la llamada quiere asignar un URI determinado al objeto que contiene el recurso real que representa el URI. El tipo de objeto devuelto es negociable; Sin embargo, la implementación siempre debe admitir System.IO.Stream.

Para obtener la versión asincrónica de este método, vea GetEntityAsync.

Importante

La aplicación puede mitigar las amenazas de denegación de servicio de memoria para el método mediante la GetEntity implementación de un IStream valor que limita el número de bytes leídos. Esto ayuda a protegerse frente a situaciones en las que el código malintencionado intenta pasar un flujo infinito de bytes al GetEntity método .

Se aplica a