Partager via


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

Définition

En cas de substitution dans une classe dérivée, mappe un URI vers un objet qui contient la ressource réelle.

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

Paramètres

absoluteUri
Uri

URI retourné par ResolveUri(Uri, String).

role
String

Pas utilisé pour l’instant.

ofObjectToReturn
Type

Type d'objet à retourner. La version actuelle ne retourne que les objets System.IO.Stream.

Retours

Object

Objet de flux ou null si un type autre que stream est spécifié.

Exceptions

ofObjectToReturn n'est pas un type Stream.

L'URI spécifié n'est pas un URI absolu.

absoluteUri a la valeur null.

Une erreur d'exécution se produit (par exemple, une interruption de la connexion au serveur).

Exemples

Consultez XmlUrlResolver.GetEntity un exemple utilisant cette méthode.

Remarques

Cette méthode est utilisée lorsque l’appelant souhaite mapper un URI donné dans l’objet contenant la ressource réelle que l’URI représente. Le type d’objet retourné est négocié ; toutefois, l’implémentation doit toujours prendre en charge System.IO.Stream.

Pour obtenir la version asynchrone de cette méthode, consultez GetEntityAsync.

Important

Votre application peut atténuer les menaces de déni de service de mémoire à la GetEntity méthode en implémentant un IStream qui limite le nombre d’octets lus. Cela permet de se prémunir contre les situations où le code malveillant tente de transmettre un flux infini d’octets à la GetEntity méthode.

S’applique à