ILSParser Interface

Référence

Définition

Espace de noms:: Org.W3c.Dom.LS

Assembly:: Mono.Android.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.

Interface vers un objet capable de générer ou d’augmenter une arborescence DOM à partir de différentes sources d’entrée.

[Android.Runtime.Register("org/w3c/dom/ls/LSParser", "", "Org.W3c.Dom.LS.ILSParserInvoker")]
public interface ILSParser : Android.Runtime.IJavaObject, IDisposable, Java.Interop.IJavaPeerable

[<Android.Runtime.Register("org/w3c/dom/ls/LSParser", "", "Org.W3c.Dom.LS.ILSParserInvoker")>]
type ILSParser = interface
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Attributs: RegisterAttribute

Implémente: IJavaObject IJavaPeerable IDisposable

Remarques

Interface vers un objet capable de générer ou d’augmenter une arborescence DOM à partir de différentes sources d’entrée.

LSParser fournit une API pour l’analyse xml et la création de la structure de document DOM correspondante. Une LSParser instance peut être obtenue en appelant la DOMImplementationLS.createLSParser() méthode.

Comme spécifié dans [DOM Level 3 Core] , lorsqu’un document est mis à disposition via le LSParser : <ul><li> il n’y aura jamais deux nœuds adjacents de type NODE_TEXT, et il n’y aura jamais de nœuds de texte vides. </li li>>< est attendu que les attributs et nodeValue les value attributs d’un Attr nœud retournent initialement la valeur normalisée XML 1.0. Toutefois, si les paramètres « validate-if-schema » et « datatype-normalization » sont définis truesur , en fonction de la normalisation d’attribut utilisée, les valeurs d’attribut peuvent différer des valeurs d’attribut obtenues par la normalisation d’attribut XML 1.0. Si les paramètres « datatype-normalization » sont définis falsesur , la normalisation d’attribut XML 1.0 est garantie et si la liste d’attributs ne contient pas de déclarations d’espace de noms, l’attribut sur Element le attributes nœud représente la propriété [attributes] définie dans [XML Information Set] . </li></ul>

Les objets asynchrones LSParser sont censés également implémenter l’interface events::EventTarget afin que les écouteurs d’événements puissent être inscrits sur des objets asynchrones LSParser .

Les événements pris en charge par les objets asynchrones LSParser sont les suivants : <dl><dt>load</dt dt><dd> . La LSParser fin du chargement du document est terminée. Consultez également la définition de l’interface LSLoadEvent . </dd><dt progress</dt dt<>>dd> La LSParser progression signale la progression à mesure que les données sont analysées. Cette spécification ne tente pas de définir exactement quand les événements de progression doivent être distribués. C’est intentionnellement laissé dépendant de l’implémentation. Voici un exemple de la façon dont une application peut distribuer des événements de progression : une fois que l’analyseur commence à recevoir des données, un événement de progression est distribué pour indiquer que l’analyse démarre. À partir de là, un événement de progression est distribué pour chaque 4096 octets de données reçues et traitées. Il s’agit d’un seul exemple, mais les implémentations peuvent choisir de distribuer des événements de progression à tout moment lors de l’analyse, ou de ne pas les distribuer du tout. Consultez également la définition de l’interface LSProgressEvent . </dd></dl>Remarque : Tous les événements définis dans cette spécification utilisent l’URI de l’espace "http://www.w3.org/2002/DOMLS"de noms .

Lors de l’analyse d’une source d’entrée, les erreurs sont signalées à l’application via le gestionnaire d’erreurs (LSParser.domConfigparamètre « gestionnaire d’erreurs »). Cette spécification n’essaie en aucun cas de définir toutes les erreurs possibles qui peuvent se produire lors de l’analyse xml, ou tout autre balisage, mais certains cas d’erreur courants sont définis. Les types (DOMError.type) d’erreurs et d’avertissements définis par cette spécification sont les suivants : <dl<>dt><"check-character-normalization-failure" [error]/dt><dd> Levée si le paramètre « check-character-normalization » a la valeur true et une chaîne est rencontrée qui échoue à la vérification de la normalisation. </dd><dt/dt><"doctype-not-allowed" [fatal]<> dd> déclenché si le paramètre de configuration « disallow-doctype » est défini true sur et qu’un doctype est rencontré. </dd><dt/dt><dd><>"no-input-specified" [fatal] déclenché lors du chargement d’un document et aucune entrée n’est spécifiée dans l’objet.LSInput </dd><dt/dt><dd>>"pi-base-uri-not-preserved" [warning]< déclenché si une instruction de traitement est rencontrée dans un emplacement où l’URI de base de l’instruction de traitement ne peut pas être conservé. Un exemple de cas dans lequel cet avertissement sera déclenché est si le paramètre de configuration « entités » est défini false sur et le fichier XML suivant est analysé :

&lt;!DOCTYPE root [ &lt;!ENTITY e SYSTEM 'subdir/myentity.ent' ]&gt;
            &lt;root&gt; &amp;e; &lt;/root&gt;

Et subdir/myentity.ent contient :

&lt;one&gt; &lt;two/&gt; &lt;/one&gt; &lt;?pi 3.14159?&gt;
            &lt;more/&gt;

</dd><dt/dt>><"unbound-prefix-in-entity" [warning]< dd dd> Un avertissement dépendant de l’implémentation qui peut être déclenché si le paramètre de configuration « espaces de noms » est défini true et qu’un préfixe d’espace de noms non lié est rencontré dans le texte de remplacement d’une entité. Le déclenchement de cet avertissement n’est pas appliqué, car certains analyseurs existants peuvent ne pas reconnaître les préfixes d’espace de noms non liés dans le texte de remplacement des entités. </dd><dt/dt><"unknown-character-denormalization" [fatal]<> dd> déclenché si le paramètre de configuration « ignore-unknown-character-denormalizations » est défini false sur et qu’un caractère est rencontré pour lequel le processeur ne peut pas déterminer les propriétés de normalisation. </dd><dt/dt><<>"unsupported-encoding" [fatal] dd> déclenché si un encodage non pris en charge est rencontré. </dd><dt/dt><"unsupported-media-type" [fatal]<> dd> déclenché si le paramètre de configuration « supported-media-types-only » est défini true sur et qu’un type de média non pris en charge est rencontré. </dd></dl>

En plus de déclencher les erreurs et avertissements définis, les implémentations sont censées déclencher des erreurs et des avertissements spécifiques à l’implémentation pour d’autres cas d’erreur et d’avertissement tels que les erreurs d’E/S (fichier introuvable, autorisation refusée,...), erreurs d’intégrité XML, etc.

Consultez également la spécification de chargement et d’enregistrement dom (Document Object Model) Level 3.

Documentation Java pour org.w3c.dom.ls.LSParser.

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.

Champs

ActionAppendAsChildren	Ajoutez le résultat de l’opération d’analyse en tant qu’enfants du nœud de contexte.
ActionInsertAfter	Insérez le résultat de l’opération d’analyse en tant que frère immédiatement suivant du nœud de contexte.
ActionInsertBefore	Insérez le résultat de l’opération d’analyse en tant que frère immédiatement précédent du nœud de contexte.
ActionReplace	Remplacez le nœud de contexte par le résultat de l’opération d’analyse.
ActionReplaceChildren	Remplacez tous les enfants du nœud de contexte par le résultat de l’opération d’analyse.

Propriétés

Async	`true` si l’élément `LSParser` est asynchrone, `false` s’il est synchrone.
Busy	`true` si le `LSParser` chargement d’un document est actuellement occupé ; sinon `false`.
DomConfig	Objet `DOMConfiguration` utilisé lors de l’analyse d’une source d’entrée.
Filter	Lorsqu’un filtre est fourni, l’implémentation appelle le filtre au fur et à mesure qu’il construit la structure de l’arborescence DOM.
Handle	Obtient la valeur JNI de l’objet Android sous-jacent. (Hérité de IJavaObject)
JniIdentityHashCode	Retourne la valeur de `java.lang.System.identityHashCode()` l’instance encapsulée. (Hérité de IJavaPeerable)
JniManagedPeerState	État de l’homologue managé. (Hérité de IJavaPeerable)
JniPeerMembers	Prise en charge de l’accès aux membres et de l’appel. (Hérité de IJavaPeerable)
PeerReference	Retourne une JniObjectReference instance d’objet Java encapsulée. (Hérité de IJavaPeerable)

Méthodes

Abort()	Abandonnez le chargement du document en cours de chargement par le `LSParser`.
Disposed()	Appelé lorsque l’instance a été supprimée. (Hérité de IJavaPeerable)
DisposeUnlessReferenced()	S’il n’existe aucune référence en suspens à cette instance, les appels `Dispose()`; sinon, ne fait rien. (Hérité de IJavaPeerable)
Finalized()	Appelé lorsque l’instance a été finalisée. (Hérité de IJavaPeerable)
Parse(ILSInput)	Analyser un document XML à partir d’une ressource identifiée par un `LSInput`.
ParseURI(String)	Analysez un document XML à partir d’un emplacement identifié par une référence d’URI [IETF RFC 2396].
ParseWithContext(ILSInput, INode, Int16)	Analysez un fragment XML d’une ressource identifiée par un `LSInput` contenu et insérez le contenu dans un document existant à la position spécifiée avec les arguments et `action` les `context` arguments.
SetJniIdentityHashCode(Int32)	Définissez la valeur retournée par `JniIdentityHashCode`. (Hérité de IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)	Interface vers un objet capable de générer ou d’augmenter une arborescence DOM à partir de différentes sources d’entrée. (Hérité de IJavaPeerable)
SetPeerReference(JniObjectReference)	Définissez la valeur retournée par `PeerReference`. (Hérité de IJavaPeerable)
UnregisterFromRuntime()	Annulez l’inscription de cette instance afin que le runtime ne le retourne pas à partir d’appels futurs Java.Interop.JniRuntime+JniValueManager.PeekValue . (Hérité de IJavaPeerable)

Méthodes d’extension

JavaCast<TResult>(IJavaObject)	Effectue une conversion de type vérifiée par le runtime Android.
JavaCast<TResult>(IJavaObject)	Interface vers un objet capable de générer ou d’augmenter une arborescence DOM à partir de différentes sources d’entrée.
GetJniTypeName(IJavaPeerable)	Interface vers un objet capable de générer ou d’augmenter une arborescence DOM à partir de différentes sources d’entrée.
ParseAsync(ILSParser, ILSInput)	Interface vers un objet capable de générer ou d’augmenter une arborescence DOM à partir de différentes sources d’entrée.
ParseURIAsync(ILSParser, String)	Interface vers un objet capable de générer ou d’augmenter une arborescence DOM à partir de différentes sources d’entrée.
ParseWithContextAsync(ILSParser, ILSInput, INode, Int16)	Interface vers un objet capable de générer ou d’augmenter une arborescence DOM à partir de différentes sources d’entrée.

S’applique à

Partager via