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 reemplaza en una clase derivada, asigna un 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 -> objPublic MustOverride Function GetEntity (absoluteUri As Uri, role As String, ofObjectToReturn As Type) As ObjectParámetros
- absoluteUri
- Uri
Identificador URI devuelto de ResolveUri(Uri, String).
- role
- String
Sin uso actualmente.
- ofObjectToReturn
- Type
Tipo de objeto que se va a devolver. La versión actual solo devuelve objetos System.IO.Stream.
Devoluciones
Objeto stream o null si se especifica un tipo distinto de stream.
Excepciones
ofObjectToReturn no es un Stream tipo.
El URI especificado no es un URI absoluto.
absoluteUri es null.
Hay un error en tiempo de ejecución (por ejemplo, una conexión de servidor interrumpida).
Ejemplos
Consulte XmlUrlResolver.GetEntity para obtener un ejemplo de uso de 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 al método GetEntity mediante la implementación de un IStream 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 una secuencia infinita de bytes al GetEntity método .
