XmlResolver.GetEntity(Uri, String, Type) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 -> objPublic MustOverride Function GetEntity (absoluteUri As Uri, role As String, ofObjectToReturn As Type) As ObjectParamè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
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.