ILSParser.ParseWithContext(ILSInput, INode, Int16) Methode
Definition
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.
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.
[Android.Runtime.Register("parseWithContext", "(Lorg/w3c/dom/ls/LSInput;Lorg/w3c/dom/Node;S)Lorg/w3c/dom/Node;", "GetParseWithContext_Lorg_w3c_dom_ls_LSInput_Lorg_w3c_dom_Node_SHandler:Org.W3c.Dom.LS.ILSParserInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public Org.W3c.Dom.INode? ParseWithContext (Org.W3c.Dom.LS.ILSInput? input, Org.W3c.Dom.INode? contextArg, short action);
[<Android.Runtime.Register("parseWithContext", "(Lorg/w3c/dom/ls/LSInput;Lorg/w3c/dom/Node;S)Lorg/w3c/dom/Node;", "GetParseWithContext_Lorg_w3c_dom_ls_LSInput_Lorg_w3c_dom_Node_SHandler:Org.W3c.Dom.LS.ILSParserInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member ParseWithContext : Org.W3c.Dom.LS.ILSInput * Org.W3c.Dom.INode * int16 -> Org.W3c.Dom.INode
Parameter
- input
- ILSInput
Das LSInput
Quelldokument, aus dem gelesen werden soll. Das Quelldokument muss ein XML-Fragment sein, d. h. alles außer einem vollständigen XML-Dokument (außer in dem Fall, in dem der Kontextknoten vom Typ DOCUMENT_NODE
ist, und die Aktion ist ACTION_REPLACE_CHILDREN
), ein DOCTYPE (interne Teilmenge), Entitätsdeklarationen, Notationsdeklarationen oder XML- oder Textdeklarationen.
- contextArg
- INode
Der Knoten, der als Kontext für die daten verwendet wird, die analysiert werden. Dieser Knoten muss ein Document
Knoten, ein DocumentFragment
Knoten oder ein Knoten eines Typs sein, der als untergeordnetes Element eines Element
Knotens zulässig ist, z. B. kein Knoten.Attribute
- action
- Int16
Dieser Parameter beschreibt, welche Aktion zwischen dem neuen Satz eingefügter Knoten und den vorhandenen untergeordneten Elementen des Kontextknotens ausgeführt werden soll. Der Satz möglicher Aktionen wird oben ACTION_TYPES
definiert.
Gibt zurück
Gibt den Knoten zurück, der das Ergebnis des Analysevorgangs ist. Wenn das Ergebnis mehr als ein Knoten der obersten Ebene ist, wird der erste zurückgegeben.
- Attribute
Ausnahmen
HIERARCHY_REQUEST_ERR: Wird ausgelöst, wenn der Inhalt nicht ersetzt, vor, nach oder als untergeordnetes Element des Kontextknotens eingefügt werden kann (siehe auch Node.insertBefore
oder Node.replaceChild
in [] ).
NOT_SUPPORTED_ERR: Wird ausgelöst, wenn diese LSParser
Methode nicht unterstützt wird oder der Kontextknoten vom Typ Document
ist und die DOM-Implementierung den Ersatz des DocumentType
untergeordneten Oder Element
untergeordneten Elements nicht unterstützt.
NO_MODIFICATION_ALLOWED_ERR: Wird ausgelöst, wenn der Kontextknoten ein schreibgeschützter Knoten ist und der Inhalt an die untergeordnete Liste angefügt wird, oder wenn der übergeordnete Knoten des Kontextknotens schreibgeschützt ist und der Inhalt in die untergeordnete Liste eingefügt wird.
INVALID_STATE_ERR: Wird ausgelöst, wenn das LSParser.busy
Attribut lautet true
.
PARSE_ERR: Wird ausgelöst, wenn das LSParser
XML-Fragment nicht geladen werden konnte. DOM-Anwendungen sollten einen DOMErrorHandler
using-Parameter "" anfügen, wenn sie Details zum Fehler erhalten möchten.
Hinweise
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. Beim Analysieren des Eingabedatenstroms wird der Kontextknoten (oder dessen übergeordnetes Element, je nachdem, wo das Ergebnis eingefügt wird) zum Auflösen ungebundener Namespacepräfixe verwendet. Der Knoten des Kontextknotens ownerDocument
(oder der Knoten selbst, wenn der Knoten vom Typ DOCUMENT_NODE
) verwendet wird, um Standardattribute und Entitätsverweise aufzulösen. <br> Da die neuen Daten in das Dokument eingefügt werden, wird mindestens ein Mutationsereignis pro neues untergeordnetes oder gleichgeordnetes Element des Kontextknotens ausgelöst. <br> Wenn es sich bei dem Kontextknoten um einen Document
Knoten handelt und die Aktion lautet ACTION_REPLACE_CHILDREN
, wird das Dokument, das als Kontextknoten übergeben wird, so geändert, dass die zugehörigen xmlEncoding
, documentURI
, , , xmlVersion
, inputEncoding
, xmlStandalone
und alle anderen solchen Attribute auf das festgelegt werden, was sie festlegen würden, wenn die Eingabequelle mithilfe LSParser.parse()
analysiert wurde. <br> Diese Methode ist immer synchron, auch wenn dies LSParser
asynchron ist (LSParser.async
ist true
). <br> Wenn beim Analysieren ein Fehler auftritt, wird der Aufrufer über die Instanz benachrichtigt, die ErrorHandler
dem Parameter " error-handler" des DOMConfiguration
. <> br Beim Aufrufen parseWithContext
werden die Werte der folgenden Konfigurationsparameter ignoriert, und ihre Standardwerte werden immer verwendet: " validate", " validate-if-schema" und " element-content-whitespace". Andere Parameter werden normal behandelt, und der Parser wird erwartet, dass er den LSParserFilter
genau so aufruft, als ob ein ganzes Dokument analysiert wurde.
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.