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

Référence

Définition

Espace de noms:: System.Xml

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

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

XmlException

ofObjectToReturn n'est pas un type Stream.

UriFormatException

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

ArgumentNullException

absoluteUri a la valeur null.

Exception

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.