XmlResolver.GetEntity(Uri, String, Type) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 .