Objekt XmlText
Das XmlText-Objekt repräsentiert den Textinhalt eines Elements oder Attributs
Der XmlText-Knoten stellt eine Reihe von Nur-Text in einem XML-Dokument dar. Da Klartext in Elementen und Attributen von XML vorkommt, werden XmlText-Knoten normalerweise alsXmlElement Knoten und XmlAttr Die untergeordneten Knoten des Knotens werden angezeigt.
XmlText-Knoten geerbt XmlCharacterData Schnittstelle über den Slave XmlCharacterData Das von der Schnittstelle geerbte Datenattribut oder von XmlNode Das von der Schnittstelle geerbte nadevalue-Attribut kann auf den Textinhalt des XmlText-Knotens zugreifen.
Verwendung von XmlCharacterDataDie geerbte Methode oder die Methode splitText(), die von der XmlText-Schnittstelle selbst definiert wird, kann den XmlText-Knoten bedienen. verwendenXmlDocument CreateTextNode, um einen neuen XmlText-Knoten zu erstellen.
Der XmlText-Knoten hat keine untergeordneten Elemente.
Informationen zum Löschen leerer XmlText-Knoten und zum Zusammenführen benachbarter XmlText-Knoten aus dem Unterbaum des Dokuments finden Sie unter XmlNode.normalize Methode.
Nachlass
Mitgliedsattribute
data
String, der im Knoten enthaltene Text
1String XmlText.data;
length
Integer, die Anzahl der im Knoten enthaltenen Zeichen
1readonly Integer XmlText.length;
nodeType
Integer, gibt den Knotentyp des Knotens zurück
1readonly Integer XmlText.nodeType;
Der nodeType verschiedener Objekte gibt unterschiedliche Werte zurück:
- XmlElement: ELEMENT_NODE(1)
- XmlAttr: ATTRIBUTE_NODE(2)
- XmlText: TEXT_NODE(3)
- XmlCDATASection: CDATA_SECTION_NODE(4)
- XmlProcessingInstruction: PROCESSING_INSTRUCTION_NODE(7)
- XmlComment: COMMENT_NODE(8)
- XmlDocument: DOCUMENT_NODE(9)
- XmlDocumentType: DOCUMENT_TYPE_NODE(10)
nodeName
String, gibt den Namen des Knotens entsprechend seinem Typ zurück
1readonly String XmlText.nodeName;
Der nodeName verschiedener Objekte gibt unterschiedliche Werte zurück:
- XmlElement: Elementname
- XmlAttr: Name des Anwesens
- XmlText: #text
- XmlCDATASection: #cdata-Abschnitt
- XmlProcessingInstruction: Zurück zum angegebenen Ziel
- XmlComment: #Kommentar
- XmlDocument: #dokumentieren
- XmlDocumentType: Dokumenttypname
nodeValue
String, gibt den Namen des Knotens entsprechend seinem Typ zurück
1String XmlText.nodeValue;
Der nodeName verschiedener Objekte gibt unterschiedliche Werte zurück:
- XmlElement: Null
- XmlAttr: Der Wert des Attributs
- XmlText: Der Inhalt des Knotens
- XmlCDATASection: Der Inhalt des Knotens
- XmlProcessingInstruction: Gibt die angegebenen Inhaltsdaten zurück
- XmlComment: Kommentartext
- XmlDocument: Null
- XmlDocumentType: Null
ownerDocument
XmlDocument, Gibt das Wurzelelement des Knotens zurück (XmlDocument Objekt)
1readonly XmlDocument XmlText.ownerDocument;
parentNode
XmlNode, Kann den Elternknoten eines Knotens zurückgeben
1readonly XmlNode XmlText.parentNode;
childNodes
XmlNodeList, Gibt die Knotenliste der Kindknoten des angegebenen Knotens zurück
1readonly XmlNodeList XmlText.childNodes;
firstChild
XmlNode, Gibt den ersten untergeordneten Knoten des Knotens zurück
1readonly XmlNode XmlText.firstChild;
lastChild
XmlNode, Den letzten untergeordneten Knoten des Knotens zurückgeben
1readonly XmlNode XmlText.lastChild;
previousSibling
XmlNode, Gibt den Knoten unmittelbar vor einem bestimmten Knoten (auf derselben Baumebene) zurück, wenn kein solcher Knoten vorhanden ist, dann gibt das Attribut null zurück
1readonly XmlNode XmlText.previousSibling;
nextSibling
XmlNode, Gibt den Knoten zurück, der einem Element unmittelbar folgt (in derselben Baumebene), wenn kein solcher Knoten vorhanden ist, gibt die Eigenschaft null zurück
1readonly XmlNode XmlText.nextSibling;
Mitgliederfunktion
splitText
Teilen Sie den Textknoten entsprechend dem angegebenen Offset in zwei Knoten auf
1XmlText XmlText.splitText(Integer offset);
Aufrufparameter:
- offset: Integer, gibt an, wo der Textknoten geteilt werden soll. Startwert beginnt bei 0
Ergebnis zurückgeben:
- XmlText, Textknoten vom aktuellen Knoten getrennt
Diese Methode teilt den XmlText-Knoten am angegebenen Offset in zwei Knoten auf. Der ursprüngliche XmlText-Knoten wird so geändert, dass er den Textinhalt (aber nicht den Textinhalt) vor der durch den Offset angegebenen Position enthält. Ein neuer XmlText-Knoten wird erstellt, um alle Zeichen ab der Offset-Position (einschließlich des Zeichens an dieser Position) bis zum Ende des ursprünglichen Zeichens zu speichern. Der neue XmlText-Knoten ist der Rückgabewert der Methode. Wenn der ursprüngliche XmlText-Knoten über einen parentNode verfügt, wird der neue XmlText-Knoten außerdem unmittelbar nach dem ursprünglichen Knoten in diesen übergeordneten Knoten eingefügt.
XmlCDATASection Die Schnittstelle erbt die XmlText-Schnittstelle, XmlCDATASection Knoten können diese Methode auch verwenden, aber der neu erstellte Knoten ist XmlCDATASection Knoten statt XmlText-Knoten.
substringData
Teilstring aus Knoten extrahieren
1
2String XmlText.substringData(Integer offset,
Integer count);
Aufrufparameter:
- offset: Integer, die Position des ersten zurückzugebenden Zeichens
- count: Integer, die Anzahl der Zeichen in der zurückzugebenden Teilzeichenfolge
Ergebnis zurückgeben:
- String, Den extrahierten String zurückgeben
appendData
Hängen Sie die Zeichenfolge an den Knoten an
1XmlText.appendData(String arg);
Aufrufparameter:
- arg: String, der an den Knoten anzuhängende String
insertData
String in Knoten einfügen
1
2XmlText.insertData(Integer offset,
String arg);
Aufrufparameter:
- offset: Integer, die Zeichenposition, an der die Zeichenfolge in den Knoten eingefügt werden soll
- arg: String, der einzufügende String
deleteData
Text aus Knoten löschen
1
2XmlText.deleteData(Integer offset,
Integer count);
Aufrufparameter:
- offset: Integer, die Position des ersten zu löschenden Zeichens
- count: Integer, die Anzahl der zu löschenden Zeichen
replaceData
Ersetzen Sie die Zeichen des Knotens durch die angegebene Zeichenfolge
1
2
3XmlText.replaceData(Integer offset,
Integer count,
String arg);
Aufrufparameter:
- offset: Integer, die Zeichenposition des zu ersetzenden Knotens
- count: Integer, die Anzahl der zu ersetzenden Zeichen
- arg: String, der einzufügende String
hasChildNodes
Abfrage, ob untergeordnete Knoten vorhanden sind
1Boolean XmlText.hasChildNodes();
Ergebnis zurückgeben:
- Boolean, Gib true zurück, wenn untergeordnete Knoten vorhanden sind, andernfalls gebe false zurück
normalize
Zusammenfügen benachbarter Textknoten und Löschen leerer Textknoten
1XmlText.normalize();
Diese Methode durchläuft alle untergeordneten Knoten des aktuellen Knotens und normalisiert das Dokument, indem der leere Text-Knoten gelöscht und alle angrenzenden Text-Knoten zusammengeführt werden. Diese Methode ist nützlich, um die Struktur des Dokumentbaums nach dem Einfügen oder Löschen von Knoten zu vereinfachen.
cloneNode
Erstellen Sie eine exakte Kopie des angegebenen Knotens
1XmlNode XmlText.cloneNode(Boolean deep = true);
Aufrufparameter:
- deep: Boolean, ob Deep Copy, wenn wahr, der geklonte Knoten klont alle untergeordneten Knoten des ursprünglichen Knotens
Ergebnis zurückgeben:
- XmlNode, Den kopierten Knoten zurückgeben
Diese Methode kopiert und gibt eine Kopie des Knotens zurück, der sie aufgerufen hat. Wenn der übergebene Parameter wahr ist, werden auch alle Nachkommen des aktuellen Knotens rekursiv kopiert. Andernfalls wird nur der aktuelle Knoten kopiert. Der zurückgegebene Knoten gehört nicht zum Dokumentbaum und seine parentNode-Eigenschaft ist null. Wenn der Elementknoten kopiert wird, werden alle seine Attribute kopiert.
lookupPrefix
Gibt das Präfix zurück, das dem angegebenen Namespace-URI auf dem aktuellen Knoten entspricht
1String XmlText.lookupPrefix(String namespaceURI);
Aufrufparameter:
- namespaceURI: String, geben Sie den passenden Namespace-URI an
Ergebnis zurückgeben:
- String, Gibt das übereinstimmende Präfix zurück, gibt null zurück, wenn es nicht übereinstimmt
lookupNamespaceURI
Gibt den Namespace-URI zurück, der dem angegebenen Präfix auf dem aktuellen Knoten entspricht
1String XmlText.lookupNamespaceURI(String prefix);
Aufrufparameter:
- prefix: String, geben Sie das passende Präfix an
Ergebnis zurückgeben:
- String, Gibt den passenden Namespace-URI zurück, gibt null zurück, wenn er nicht übereinstimmt
insertBefore
Fügen Sie einen neuen untergeordneten Knoten vor dem vorhandenen untergeordneten Knoten ein
1
2XmlNode XmlText.insertBefore(XmlNode newChild,
XmlNode refChild);
Aufrufparameter:
- newChild: XmlNode, Füge einen neuen Knoten ein
- refChild: XmlNode, Füge einen neuen Knoten vor diesem Knoten ein
Ergebnis zurückgeben:
- XmlNode, Gibt den neuen untergeordneten Knoten zurück
Existiert newChild bereits im Dokumentenbaum, wird es aus dem Dokumentenbaum gelöscht und an seiner neuen Position wieder eingefügt. Knoten aus einem Dokument (oder von einem Dokument erstellte Knoten) können nicht in ein anderes Dokument eingefügt werden. Mit anderen Worten, die OwnerDocument-Eigenschaft von newChild muss mit der ownerDocument-Eigenschaft des aktuellen Knotens übereinstimmen.
insertAfter
Fügen Sie einen neuen untergeordneten Knoten nach dem vorhandenen untergeordneten Knoten ein
1
2XmlNode XmlText.insertAfter(XmlNode newChild,
XmlNode refChild);
Aufrufparameter:
- newChild: XmlNode, Füge einen neuen Knoten ein
- refChild: XmlNode, Fügen Sie nach diesem Knoten einen neuen Knoten ein
Ergebnis zurückgeben:
- XmlNode, Gibt den neuen untergeordneten Knoten zurück
Existiert newChild bereits im Dokumentenbaum, wird es aus dem Dokumentenbaum gelöscht und an seiner neuen Position wieder eingefügt. Knoten aus einem Dokument (oder von einem Dokument erstellte Knoten) können nicht in ein anderes Dokument eingefügt werden. Mit anderen Worten, die OwnerDocument-Eigenschaft von newChild muss mit der ownerDocument-Eigenschaft des aktuellen Knotens übereinstimmen.
appendChild
Fügen Sie am Ende der Liste der untergeordneten Knoten des Knotens einen neuen untergeordneten Knoten hinzu
1XmlNode XmlText.appendChild(XmlNode newChild);
Aufrufparameter:
- newChild: XmlNode, Geben Sie den hinzugefügten Knoten an
Ergebnis zurückgeben:
- XmlNode, Diesen neuen untergeordneten Knoten zurückgeben
Existiert newChild bereits im Dokumentenbaum, wird es aus dem Dokumentenbaum gelöscht und an seiner neuen Position wieder eingefügt. Knoten aus einem Dokument (oder von einem Dokument erstellte Knoten) können nicht in ein anderes Dokument eingefügt werden. Mit anderen Worten, die OwnerDocument-Eigenschaft von newChild muss mit der ownerDocument-Eigenschaft des aktuellen Knotens übereinstimmen.
replaceChild
Ersetzen Sie einen untergeordneten Knoten durch einen anderen
1
2XmlNode XmlText.replaceChild(XmlNode newChild,
XmlNode oldChild);
Aufrufparameter:
- newChild: XmlNode, Geben Sie einen neuen Knoten an
- oldChild: XmlNode, Geben Sie den zu ersetzenden Knoten an
Ergebnis zurückgeben:
- XmlNode, Wenn die Ersetzung erfolgreich ist, kann diese Methode den ersetzten Knoten zurückgeben, wenn die Ersetzung fehlschlägt, gibt sie null zurück
Existiert newChild bereits im Dokumentenbaum, wird es aus dem Dokumentenbaum gelöscht und an seiner neuen Position wieder eingefügt. Knoten aus einem Dokument (oder von einem Dokument erstellte Knoten) können nicht in ein anderes Dokument eingefügt werden. Mit anderen Worten, die OwnerDocument-Eigenschaft von newChild muss mit der ownerDocument-Eigenschaft des aktuellen Knotens übereinstimmen.
removeChild
Einen Knoten aus der Liste der untergeordneten Knoten entfernen
1XmlNode XmlText.removeChild(XmlNode oldChild);
Aufrufparameter:
- oldChild: XmlNode, Geben Sie den zu löschenden Knoten an
Ergebnis zurückgeben:
- XmlNode, Wenn das Löschen erfolgreich ist, kann diese Methode den gelöschten Knoten zurückgeben, wenn sie fehlschlägt, gibt sie null zurück
toString
Gibt die String-Darstellung des Objekts zurück, gibt im Allgemeinen "[Native Object]" zurück, das Objekt kann entsprechend seiner eigenen Eigenschaften neu implementiert werden
1String XmlText.toString();
Ergebnis zurückgeben:
- String, Gibt die String-Darstellung des Objekts zurück
toJSON
Gibt die Darstellung des Objekts im JSON-Format zurück, gibt im Allgemeinen eine Sammlung von lesbaren Attributen zurück, die durch das Objekt definiert sind
1Value XmlText.toJSON(String key = "");
Aufrufparameter:
- key: String, unbenutzt
Ergebnis zurückgeben:
- Value, Gibt einen Wert zurück, der JSON serialisierbar enthält