ILSParser Schnittstelle

Referenz

Definition

Namespace:: Org.W3c.Dom.LS

Assembly:: Mono.Android.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Eine Schnittstelle zu einem Objekt, das eine DOM-Struktur aus verschiedenen Eingabequellen erstellen oder erweitern kann.

[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

Attribute: RegisterAttribute

Implementiert: IJavaObject IJavaPeerable IDisposable

Hinweise

Eine Schnittstelle zu einem Objekt, das eine DOM-Struktur aus verschiedenen Eingabequellen erstellen oder erweitern kann.

LSParser stellt eine API zum Analysieren von XML bereit und erstellt die entsprechende DOM-Dokumentstruktur. Eine LSParser Instanz kann durch Aufrufen der DOMImplementationLS.createLSParser() Methode abgerufen werden.

Wie in [DOM Level 3 Core] angegeben, wenn ein Dokument zum ersten Mal über den LSParser verfügbar gemacht wird: <ul><li> gibt es nie zwei angrenzende Knoten vom Typ NODE_TEXT, und es gibt nie leere Textknoten. </li li>>< es wird erwartet, dass die value und nodeValue die Attribute eines Attr Knotens zunächst den normalisierten XML 1.0-Wert zurückgeben. Wenn die Parameter "validate-if-schema" und "datatype-normalization" jedoch abhängig von der verwendeten Attributnormalisierung festgelegt truesind, können sich die Attributwerte von denen unterscheiden, die durch die XML 1.0-Attributnormalisierung abgerufen wurden. Wenn die Parameter " Datentypnormalisierung" festgelegt falseist, wird die XML 1.0-Attributnormalisierung garantiert auftreten, und wenn die Attributliste keine Namespacedeklarationen enthält, stellt das attributes Attribut auf Element dem Knoten die eigenschaft <b>[attributes]</b> dar, die in [XML Information Set] definiert ist. </li></ul>

Asynchrone LSParser Objekte werden auch die events::EventTarget Schnittstelle implementieren, sodass Ereignislistener für asynchrone LSParser Objekte registriert werden können.

Von asynchronen LSParser Objekten unterstützte Ereignisse sind: <dl<>dt>load</dt><dd> The LSParser finishes to load the document. Siehe auch die Definition der LSLoadEvent Schnittstelle. </dd><dt>progress/dt><dd> The LSParser signals progress< as data is parsed. Diese Spezifikation versucht nicht, genau zu definieren, wann Statusereignisse verteilt werden sollen. Dies wird absichtlich als implementierungsabhängig gelassen. Nachfolgend sehen Sie ein Beispiel dafür, wie eine Anwendung Fortschrittsereignisse verteilen kann: Sobald der Parser mit dem Empfangen von Daten beginnt, wird ein Statusereignis verteilt, um anzugeben, dass die Analyse beginnt. Von dort aus wird ein Statusereignis für alle 4096 Byte von Daten verteilt, die empfangen und verarbeitet werden. Dies ist jedoch nur ein Beispiel, und Implementierungen können sich entscheiden, Statusereignisse jederzeit während der Analyse zu verteilen oder überhaupt nicht zu verteilen. Siehe auch die Definition der LSProgressEvent Schnittstelle. </dd></dl><p b>>< Hinweis:</b> Alle in dieser Spezifikation definierten Ereignisse verwenden den Namespace-URI"http://www.w3.org/2002/DOMLS".

Beim Analysieren einer Eingabequelle werden Fehler über den Fehlerhandler (LSParser.domConfigder Parameter " error-handler" ) an die Anwendung gemeldet. Diese Spezifikation versucht nicht, alle möglichen Fehler zu definieren, die beim Analysieren von XML oder einem anderen Markup auftreten können, aber einige häufige Fehlerfälle sind definiert. Die Typen (DOMError.type) von Fehlern und Warnungen, die durch diese Spezifikation definiert wurden, sind: <dl<>dt"check-character-normalization-failure" [error]<>/dt><dd> Raised, wenn der Parameter "Check-character-normalization" auf "true" festgelegt ist und eine Zeichenfolge gefunden wird, die eine Normalisierungsprüfung fehlschlägt. </dd><dt>"doctype-not-allowed" [fatal]</dt><dd> Raised if the configuration parameter "disallow-doctype" is set to true and a doctype is encountered. </dd><dt>"no-input-specified" [fatal]</dt><dd> Raised beim Laden eines Dokuments und keine Eingabe im LSInput Objekt angegeben ist. </dd><dt>"pi-base-uri-not-preserved" [warning]</dt><dd> Raised if a processing instruction is encountered in a location where the base URI of the processing instruction can not be preserved. Ein Beispiel für einen Fall, in dem diese Warnung ausgelöst wird, ist, wenn der Konfigurationsparameter " entities" auf und false die folgende XML-Datei analysiert wird:

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

Und subdir/myentity.ent enthält:

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

</dd><dt>"unbound-prefix-in-entity" [warning]</dt><dd> Eine implementierungsabhängige Warnung, die ausgelöst werden kann, wenn der Konfigurationsparameter " Namespaces" festgelegt true ist und ein ungebundenes Namespacepräfix im Ersetzungstext einer Entität gefunden wird. Das Auslösen dieser Warnung wird nicht erzwungen, da einige vorhandene Parser möglicherweise keine ungebundenen Namespacepräfixe im Ersetzungstext von Entitäten erkennen. </dd><dt>"unknown-character-denormalization" [fatal]</dt><dd> Raised if the configuration parameter "ignore-unknown-character-denormalizations" is set to false and a character is encountered for which the processor cannot determine the normalization properties. </dd><dt>"unsupported-encoding" [fatal]</dt><dd> Raised, wenn eine nicht unterstützte Codierung gefunden wird. </dd><dt>"unsupported-media-type" [fatal]</dt><dd> Raised, wenn der Konfigurationsparameter "supported-media-types-only" auf und true ein nicht unterstützter Medientyp gefunden wird. </dd></dl>

Neben dem Auslösen der definierten Fehler und Warnungen werden Implementierungen erwartet, dass implementierungsspezifische Fehler und Warnungen für andere Fehler- und Warnungsfälle wie E/A-Fehler (Datei nicht gefunden, Berechtigung verweigert,...), XML-Wohlformheitsfehler usw. ausgelöst werden.

Siehe auch das Dokumentobjektmodell (DOM) Level 3 Load and Save Specification.

Java-Dokumentation für org.w3c.dom.ls.LSParser.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Felder

ActionAppendAsChildren	Fügen Sie das Ergebnis des Analysevorgangs als untergeordnete Elemente des Kontextknotens an.
ActionInsertAfter	Fügen Sie das Ergebnis des Analysevorgangs als das unmittelbar folgende gleichgeordnete Element des Kontextknotens ein.
ActionInsertBefore	Fügen Sie das Ergebnis des Analysevorgangs als das unmittelbar vorangehende gleichgeordnete Element des Kontextknotens ein.
ActionReplace	Ersetzen Sie den Kontextknoten durch das Ergebnis des Analysevorgangs.
ActionReplaceChildren	Ersetzen Sie alle untergeordneten Elemente des Kontextknotens durch das Ergebnis des Analysevorgangs.

Eigenschaften

Async	`true` wenn dies `LSParser` asynchron ist, `false` wenn sie synchron ist.
Busy	`true` wenn das `LSParser` Laden eines Dokuments gerade ausgelastet ist, andernfalls `false`.
DomConfig	Das `DOMConfiguration` Objekt, das beim Analysieren einer Eingabequelle verwendet wird.
Filter	Wenn ein Filter bereitgestellt wird, ruft die Implementierung beim Erstellen der DOM-Struktur den Filter auf.
Handle	Ruft den JNI-Wert des zugrunde liegenden Android-Objekts ab. (Geerbt von IJavaObject)
JniIdentityHashCode	Gibt den Wert `java.lang.System.identityHashCode()` für die umbrochene Instanz zurück. (Geerbt von IJavaPeerable)
JniManagedPeerState	Status des verwalteten Peers. (Geerbt von IJavaPeerable)
JniPeerMembers	Mitgliedszugriff und Aufrufunterstützung. (Geerbt von IJavaPeerable)
PeerReference	Gibt eine JniObjectReference der umbrochenen Java-Objektinstanz zurück. (Geerbt von IJavaPeerable)

Methoden

Abort()	Beenden Sie das Laden des Dokuments, das derzeit von der `LSParser`Datei geladen wird.
Disposed()	Wird aufgerufen, wenn die Instanz verworfen wurde. (Geerbt von IJavaPeerable)
DisposeUnlessReferenced()	Wenn keine offenen Verweise auf diese Instanz vorhanden sind, wird nichts aufgerufen `Dispose()`. Andernfalls wird nichts ausgeführt. (Geerbt von IJavaPeerable)
Finalized()	Wird aufgerufen, wenn die Instanz abgeschlossen wurde. (Geerbt von IJavaPeerable)
Parse(ILSInput)	Analysieren eines XML-Dokuments aus einer Ressource, die durch eine `LSInput`.
ParseURI(String)	Analysieren eines XML-Dokuments von einem Speicherort, der durch einen URI-Verweis identifiziert wird [IETF RFC 2396].
ParseWithContext(ILSInput, INode, Int16)	Analysieren Sie ein XML-Fragment aus einer Ressource, die durch eine `LSInput` Ressource identifiziert wird, und fügen Sie den Inhalt an der position ein, die mit den `context` Argumenten `action` angegeben ist, in ein vorhandenes Dokument ein.
SetJniIdentityHashCode(Int32)	Legen Sie den von `JniIdentityHashCode`. (Geerbt von IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)	Eine Schnittstelle zu einem Objekt, das eine DOM-Struktur aus verschiedenen Eingabequellen erstellen oder erweitern kann. (Geerbt von IJavaPeerable)
SetPeerReference(JniObjectReference)	Legen Sie den von `PeerReference`. (Geerbt von IJavaPeerable)
UnregisterFromRuntime()	Heben Sie die Registrierung dieser Instanz auf, damit die Laufzeit sie nicht aus zukünftigen Java.Interop.JniRuntime+JniValueManager.PeekValue Aufrufen zurückgibt. (Geerbt von IJavaPeerable)

Erweiterungsmethoden

JavaCast<TResult>(IJavaObject)	Führt eine android-laufzeitgecheckte Typkonvertierung aus.
JavaCast<TResult>(IJavaObject)	Eine Schnittstelle zu einem Objekt, das eine DOM-Struktur aus verschiedenen Eingabequellen erstellen oder erweitern kann.
GetJniTypeName(IJavaPeerable)	Eine Schnittstelle zu einem Objekt, das eine DOM-Struktur aus verschiedenen Eingabequellen erstellen oder erweitern kann.
ParseAsync(ILSParser, ILSInput)	Eine Schnittstelle zu einem Objekt, das eine DOM-Struktur aus verschiedenen Eingabequellen erstellen oder erweitern kann.
ParseURIAsync(ILSParser, String)	Eine Schnittstelle zu einem Objekt, das eine DOM-Struktur aus verschiedenen Eingabequellen erstellen oder erweitern kann.
ParseWithContextAsync(ILSParser, ILSInput, INode, Int16)	Eine Schnittstelle zu einem Objekt, das eine DOM-Struktur aus verschiedenen Eingabequellen erstellen oder erweitern kann.

Gilt für:

Freigeben über