IEntityResolver.ResolveEntity(String, String) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Consentire all'applicazione di risolvere le entità esterne.
[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
Parametri
- publicId
- String
Identificatore pubblico dell'entità esterna a cui viene fatto riferimento oppure Null se non è stato specificato alcun valore.
- systemId
- String
Identificatore di sistema dell'entità esterna a cui viene fatto riferimento.
Restituisce
Oggetto InputSource che descrive la nuova origine di input o null per richiedere che il parser apra una normale connessione URI all'identificatore di sistema.
- Attributi
Eccezioni
Qualsiasi eccezione SAX, eventualmente con wrapping di un'altra eccezione.
Eccezione di I/O specifica di Java, probabilmente il risultato della creazione di un nuovo inputStream o lettore per InputSource.
Commenti
Consentire all'applicazione di risolvere le entità esterne.
Il parser chiamerà questo metodo prima di aprire qualsiasi entità esterna, ad eccezione dell'entità documento di primo livello. Tali entità includono il subset DTD esterno e le entità di parametro esterne a cui viene fatto riferimento all'interno del DTD (in entrambi i casi, solo se il parser legge le entità di parametro esterne) e le entità generali esterne a cui viene fatto riferimento all'interno dell'elemento documento (se il parser legge entità generali esterne). L'applicazione può richiedere al parser di individuare l'entità stessa, di usare un URI alternativo o di usare i dati forniti dall'applicazione (come flusso di input di caratteri o byte).
Gli autori di applicazioni possono usare questo metodo per reindirizzare gli identificatori di sistema esterni agli URI sicuri e/o locali, per cercare gli identificatori pubblici in un catalogo o per leggere un'entità da un database o da un'altra origine di input (ad esempio, una finestra di dialogo). Né XML né SAX specifica un criterio preferito per l'uso di ID pubblici o di sistema per risolvere le risorse. Tuttavia, SAX specifica come interpretare qualsiasi InputSource restituito da questo metodo e che, se non viene restituito alcuno, l'ID di sistema verrà dereferenziato come URL.
Se l'identificatore di sistema è un URL, il parser SAX deve risolverlo completamente prima di segnalarlo all'applicazione.
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.