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

Definición

Espacio de nombres:

System.Xml

Ensamblado:

System.Xml.ReaderWriter.dll

Source:

XmlResolver.cs

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);

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

Object

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

Excepciones

XmlException

ofObjectToReturn no es un tipo de Stream.

UriFormatException

El identificador URI especificado no es un identificador URI absoluto.

ArgumentNullException

absoluteUri es null.

Exception

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 .