Partager via


IEntityResolver.ResolveEntity(String, String) Méthode

Définition

Autoriser l’application à résoudre les entités externes.

[Android.Runtime.Register("resolveEntity", "(Ljava/lang/String;Ljava/lang/String;)Lorg/xml/sax/InputSource;", "GetResolveEntity_Ljava_lang_String_Ljava_lang_String_Handler:Org.Xml.Sax.IEntityResolverInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public Org.Xml.Sax.InputSource? ResolveEntity (string? publicId, string? systemId);
[<Android.Runtime.Register("resolveEntity", "(Ljava/lang/String;Ljava/lang/String;)Lorg/xml/sax/InputSource;", "GetResolveEntity_Ljava_lang_String_Ljava_lang_String_Handler:Org.Xml.Sax.IEntityResolverInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member ResolveEntity : string * string -> Org.Xml.Sax.InputSource

Paramètres

publicId
String

Identificateur public de l’entité externe référencée ou Null si aucune n’a été fournie.

systemId
String

Identificateur système de l’entité externe référencée.

Retours

Objet InputSource décrivant la nouvelle source d’entrée ou null pour demander que l’analyseur ouvre une connexion URI régulière à l’identificateur système.

Attributs

Exceptions

Toute exception SAX, éventuellement encapsuler une autre exception.

Exception d’E/S spécifique à Java, éventuellement le résultat de la création d’un inputStream ou d’un lecteur pour InputSource.

Remarques

Autoriser l’application à résoudre les entités externes.

L’analyseur appelle cette méthode avant d’ouvrir une entité externe à l’exception de l’entité de document de niveau supérieur. Ces entités incluent le sous-ensemble DTD externe et les entités de paramètres externes référencées dans le DTD (dans les deux cas, uniquement si l’analyseur lit les entités de paramètres externes) et les entités générales externes référencées dans l’élément de document (si l’analyseur lit des entités générales externes). L’application peut demander à l’analyseur de localiser l’entité elle-même, qu’elle utilise un URI de remplacement ou qu’elle utilise des données fournies par l’application (en tant que flux d’entrée de caractère ou d’octet).

Les enregistreurs d’applications peuvent utiliser cette méthode pour rediriger les identificateurs système externes vers des URI sécurisés et/ou locaux, pour rechercher des identificateurs publics dans un catalogue ou pour lire une entité à partir d’une base de données ou d’une autre source d’entrée (y compris, par exemple, une boîte de dialogue). Ni XML ni SAX ne spécifient une stratégie préférée pour l’utilisation d’ID publics ou système pour résoudre les ressources. Toutefois, SAX spécifie comment interpréter n’importe quelle InputSource retournée par cette méthode, et que si aucun n’est retourné, l’ID système sera déréférencé en tant qu’URL.

Si l’identificateur système est une URL, l’analyseur SAX doit le résoudre entièrement avant de le signaler à l’application.

Documentation Java pour org.xml.sax.EntityResolver.resolveEntity(java.lang.String, java.lang.String).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.

S’applique à

Voir aussi