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. benutzenXmlDocument 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.

Erbe

Mitgliedsattribute

data

String, der im Knoten enthaltene Text

1
String 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

1
readonly 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: #dokument
XmlDocumentType: Dokumenttypname

nodeValue

String, gibt den Namen des Knotens entsprechend seinem Typ zurück

1
String 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 direkt 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 direkt 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
2
String 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

1
XmlText.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
2
XmlText.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
3
XmlText.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

1
Boolean 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 delete

1XmlText.normalize();

Diese Methode durchläuft alle Nachkommen 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

1
XmlNode 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 an ihn ü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

1
String 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

1
String 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
2
XmlNode 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 identisch sein.

insertAfter

Fügen Sie einen neuen untergeordneten Knoten nach dem vorhandenen untergeordneten Knoten ein

1
2
XmlNode 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

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

replaceChild

Ersetzen Sie einen untergeordneten Knoten durch einen anderen

1
2
XmlNode 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

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

1
String 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

1
Value XmlText.toJSON(String key = "");

Aufrufparameter:

key: String, unbenutzt

Ergebnis zurückgeben:

Value, Gibt einen Wert zurück, der JSON serialisierbar enthält

Entwicklungsleitfaden

Basismodul

Eingebaute Objekte

Community-Modul

Objekt XmlText

Erbe

Mitgliedsattribute

data

length

nodeType

nodeName

nodeValue

ownerDocument

parentNode

childNodes

firstChild

lastChild

previousSibling

nextSibling

Mitgliederfunktion

splitText

substringData

appendData

insertData

deleteData

replaceData

hasChildNodes

normalize

cloneNode

lookupPrefix

lookupNamespaceURI

insertBefore

insertAfter

appendChild

replaceChild

removeChild

toString

toJSON