Objekt integriertes Objekt

ObjectXmlText

Ein XmlText-Objekt repräsentiert den Textinhalt eines Elements oder Attributs

Der XmlText-Knoten stellt eine Folge von reinem Text in einem XML-Dokument dar. Da in XML-Elementen und -Attributen einfacher Text vorkommt, ist dies normalerweise der XmlText-KnotenXmlElementKnotensummeXmlAttrDie untergeordneten Knoten des Knotens werden angezeigt.

XmlText-Knoten erbenXmlCharacterDataSchnittstelle, überXmlCharacterDataDatenattribut, das von der Schnittstelle oder von geerbt wurdeXmlNodeDas von der Schnittstelle geerbte Nadevalue-Attribut kann auf den Textinhalt des XmlText-Knotens zugreifen.

verwenden vonXmlCharacterDataGeerbte Methoden oder die von der XmlText-Schnittstelle selbst definierte Methode splitText() können XmlText-Knoten bedienen. verwendenXmlDocumentcreateTextNode, um einen neuen XmlText-Knoten zu erstellen.

Der XmlText-Knoten hat keine untergeordneten Knoten.

Methoden zum Löschen leerer XmlText-Knoten und zum Zusammenführen benachbarter XmlText-Knoten aus einer Unterstruktur eines Dokuments finden Sie unterXmlNode.normalizeMethode.

Erbschaftsverhältnis

Mitgliedereigenschaften

data

String, der in diesem Knoten enthaltene Text

1
String XmlText.data;

length

Ganzzahl, die Anzahl der in diesem Knoten enthaltenen Zeichen

1
readonly Integer XmlText.length;

nodeType

Ganzzahl, gibt den Knotentyp des Knotens zurück

1
readonly Integer XmlText.nodeType;

Der Knotentyp verschiedener Objekte gibt unterschiedliche Werte zurück:


nodeName

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

1
readonly String XmlText.nodeName;

Der Knotenname verschiedener Objekte gibt unterschiedliche Werte zurück:


nodeValue

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

1
String XmlText.nodeValue;

Der Knotenname verschiedener Objekte gibt unterschiedliche Werte zurück:


ownerDocument

XmlDocument, gibt das Wurzelelement des Knotens zurück (XmlDocumentObjekt)

1
readonly XmlDocument XmlText.ownerDocument;

parentNode

XmlNode, kann den übergeordneten Knoten eines Knotens zurückgeben

1
readonly XmlNode XmlText.parentNode;

childNodes

XmlNodeList, gibt die Knotenliste der untergeordneten Knoten des angegebenen Knotens zurück

1
readonly XmlNodeList XmlText.childNodes;

children

XmlNodeList, gibt die Knotenliste der untergeordneten Elementknoten des angegebenen Knotens zurück.

1
readonly XmlNodeList XmlText.children;

firstChild

XmlNode, gibt den ersten untergeordneten Knoten des Knotens zurück

1
readonly XmlNode XmlText.firstChild;

lastChild

XmlNode, gibt den letzten untergeordneten Knoten des Knotens zurück

1
readonly XmlNode XmlText.lastChild;

previousSibling

XmlNode, gibt den Knoten zurück, der einem Knoten unmittelbar vorangeht (auf derselben Baumebene). Wenn kein solcher Knoten vorhanden ist, gibt diese Eigenschaft null zurück.

1
readonly XmlNode XmlText.previousSibling;

nextSibling

XmlNode, gibt den Knoten zurück, der unmittelbar auf ein Element folgt (in derselben Baumebene). Wenn kein solcher Knoten vorhanden ist, gibt das Attribut null zurück.

1
readonly XmlNode XmlText.nextSibling;

firstElementChild

XmlNode, gibt den ersten untergeordneten Elementknoten des Knotens zurück

1
readonly XmlNode XmlText.firstElementChild;

lastElementChild

XmlNode, gibt den letzten untergeordneten Elementknoten des Knotens zurück

1
readonly XmlNode XmlText.lastElementChild;

previousElementSibling

XmlNode, gibt den Elementknoten zurück, der einem Knoten unmittelbar vorangeht (auf derselben Baumebene). Wenn kein solcher Knoten vorhanden ist, gibt diese Eigenschaft null zurück.

1
readonly XmlNode XmlText.previousElementSibling;

nextElementSibling

XmlNode, gibt den Elementknoten zurück, der unmittelbar auf ein Element folgt (in derselben Baumebene). Wenn kein solcher Knoten vorhanden ist, gibt das Attribut null zurück.

1
readonly XmlNode XmlText.nextElementSibling;

textContent

String, fragt den Text des ausgewählten Elements ab und legt ihn fest. Gibt beim Abfragen die Werte aller Textknoten innerhalb des Elementknotens zurück; beim Festlegen werden alle untergeordneten Knoten gelöscht und durch einen einzelnen Textknoten ersetzt.

1
String XmlText.textContent;

Mitgliedsfunktion

splitText

Teilen Sie den Textknoten entsprechend dem angegebenen Versatz in zwei Knoten auf

1
XmlText XmlText.splitText(Integer offset);

Aufrufparameter:

  • offset: Ganzzahl, gibt an, wo Textknoten geteilt werden sollen. Der Startwert beginnt bei 0

Rückgabeergebnisse:

  • XmlText, Textknoten vom aktuellen Knoten getrennt

Diese Methode teilt den XmlText-Knoten am angegebenen Offset in zwei Knoten. Der ursprüngliche XmlText-Knoten wird so geändert, dass er den Textinhalt vor (jedoch nicht einschließlich) dem Textinhalt an der durch den Offset angegebenen Position enthält. Es wird ein neuer XmlText-Knoten erstellt, um alle Zeichen von der Offset-Position (einschließlich der Zeichen an dieser Position) bis zum Ende des ursprünglichen Zeichens zu speichern. Der neue XmlText-Knoten ist der Rückgabewert dieser Methode. Wenn der ursprüngliche XmlText-Knoten außerdem über einen parentNode verfügt, wird der neue XmlText-Knoten direkt nach dem ursprünglichen Knoten in diesen übergeordneten Knoten eingefügt.

XmlCDATASectionDie Schnittstelle erbt die XmlText-Schnittstelle.XmlCDATASectionKnoten können diese Methode ebenfalls verwenden, die neu erstellten Knoten jedochXmlCDATASectionKnoten anstelle eines XmlText-Knotens.


substringData

Teilzeichenfolge aus Knoten extrahieren

1 2
String XmlText.substringData(Integer offset, Integer count);

Aufrufparameter:

  • offset: Ganzzahl, die Position des ersten zurückzugebenden Zeichens
  • count: Ganzzahl, die Anzahl der Zeichen in der Teilzeichenfolge, die zurückgegeben werden soll

Rückgabeergebnisse:

  • String, gibt die extrahierte Zeichenfolge zurück

appendData

Zeichenfolge an Knoten anhängen

1
XmlText.appendData(String arg);

Aufrufparameter:

  • arg: String, der String, der an den Knoten angehängt werden soll

insertData

Zeichenfolge in Knoten einfügen

1 2
XmlText.insertData(Integer offset, String arg);

Aufrufparameter:

  • offset: Ganzzahl, die Zeichenposition, an der die Zeichenfolge in den Knoten eingefügt werden soll
  • arg: String, der einzufügende String

deleteData

Text vom Knoten entfernen

1 2
XmlText.deleteData(Integer offset, Integer count);

Aufrufparameter:

  • offset: Ganzzahl, die Position des ersten zu löschenden Zeichens
  • count: Ganzzahl, 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: Ganzzahl, die Zeichenposition des zu ersetzenden Knotens
  • count: Ganzzahl, die Anzahl der zu ersetzenden Zeichen
  • arg: String, der einzufügende String

hasChildNodes

Fragen Sie ab, ob untergeordnete Knoten vorhanden sind

1
Boolean XmlText.hasChildNodes();

Rückgabeergebnisse:

  • Boolean, gibt „true“ zurück, wenn es untergeordnete Knoten gibt, andernfalls wird „false“ zurückgegeben

normalize

Benachbarte Textknoten zusammenführen und leere Textknoten löschen

1
XmlText.normalize();

Diese Methode durchläuft alle Nachkommenknoten des aktuellen Knotens und normalisiert das Dokument, indem leere Textknoten gelöscht und alle angrenzenden Textknoten 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

Erstellt eine exakte Kopie des angegebenen Knotens

1
XmlNode XmlText.cloneNode(Boolean deep = true);

Aufrufparameter:

  • deep: Boolescher Wert, ob tief kopiert werden soll. Wenn true, klont der geklonte Knoten alle untergeordneten Knoten des ursprünglichen Knotens

Rückgabeergebnisse:

  • XmlNode, gibt den kopierten Knoten zurück

Diese Methode kopiert den Knoten, auf dem sie aufgerufen wurde, und gibt eine Kopie zurück. Wenn das übergebene Argument wahr ist, werden auch alle Nachkommenknoten 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 ein Elementknoten kopiert wird, werden alle seine Eigenschaften 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, gibt den passenden Namespace-URI an

Rückgabeergebnisse:

  • String, gibt das passende 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, gibt das passende Präfix an

Rückgabeergebnisse:

  • 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 einem vorhandenen untergeordneten Knoten ein

1 2
XmlNode XmlText.insertBefore(XmlNode newChild, XmlNode refChild);

Aufrufparameter:

  • newChild:XmlNode, neuen Knoten einfügen
  • refChild:XmlNode, fügen Sie vor diesem Knoten einen neuen Knoten ein

Rückgabeergebnisse:

  • XmlNode, gibt den neuen untergeordneten Knoten zurück

Wenn newChild bereits im Dokumentbaum vorhanden ist, wird es aus dem Dokumentbaum entfernt 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. Das heißt, das Attribut „ownerDocument“ von „newChild“ muss mit dem Attribut „ownerDocument“ des aktuellen Knotens identisch sein.


insertAfter

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

1 2
XmlNode XmlText.insertAfter(XmlNode newChild, XmlNode refChild);

Aufrufparameter:

  • newChild:XmlNode, neuen Knoten einfügen
  • refChild:XmlNode, fügen Sie nach diesem Knoten einen neuen Knoten ein

Rückgabeergebnisse:

  • XmlNode, gibt den neuen untergeordneten Knoten zurück

Wenn newChild bereits im Dokumentbaum vorhanden ist, wird es aus dem Dokumentbaum entfernt 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. Das heißt, das Attribut „ownerDocument“ von „newChild“ muss mit dem Attribut „ownerDocument“ des aktuellen Knotens identisch sein.


appendChild

Fügt am Ende der Liste der untergeordneten Knoten eines Knotens einen neuen untergeordneten Knoten hinzu

1
XmlNode XmlText.appendChild(XmlNode newChild);

Aufrufparameter:

  • newChild:XmlNodeGeben Sie den hinzugefügten Knoten an

Rückgabeergebnisse:

  • XmlNode, gibt diesen neuen untergeordneten Knoten zurück

Wenn newChild bereits im Dokumentbaum vorhanden ist, wird es aus dem Dokumentbaum entfernt 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. Das heißt, das Attribut „ownerDocument“ von „newChild“ muss mit dem Attribut „ownerDocument“ des aktuellen Knotens identisch sein.


replaceChild

Ersetzen Sie einen untergeordneten Knoten durch einen anderen

1 2
XmlNode XmlText.replaceChild(XmlNode newChild, XmlNode oldChild);

Aufrufparameter:

  • newChild:XmlNode, geben Sie den neuen Knoten an
  • oldChild:XmlNode, gibt den zu ersetzenden Knoten an

Rückgabeergebnisse:

  • XmlNodeWenn die Ersetzung erfolgreich ist, kann diese Methode den ersetzten Knoten zurückgeben. Wenn die Ersetzung fehlschlägt, gibt sie null zurück.

Wenn newChild bereits im Dokumentbaum vorhanden ist, wird es aus dem Dokumentbaum entfernt 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. Das heißt, das Attribut „ownerDocument“ von „newChild“ muss mit dem Attribut „ownerDocument“ des aktuellen Knotens identisch sein.


removeChild

Entfernen Sie einen Knoten aus der Liste der untergeordneten Knoten

1
XmlNode XmlText.removeChild(XmlNode oldChild);

Aufrufparameter:

  • oldChild:XmlNode, gibt den zu löschenden Knoten an

Rückgabeergebnisse:

  • XmlNode, Wenn der Löschvorgang erfolgreich ist, kann diese Methode den gelöschten Knoten zurückgeben. Wenn dies fehlschlägt, gibt sie null zurück.

toString

Gibt die Zeichenfolgendarstellung des Objekts zurück. Im Allgemeinen wird „[Native Object]“ zurückgegeben. Das Objekt kann gemäß seinen eigenen Eigenschaften neu implementiert werden.

1
String XmlText.toString();

Rückgabeergebnisse:

  • String, gibt die Zeichenfolgendarstellung des Objekts zurück

toJSON

Gibt eine Darstellung des Objekts im JSON-Format zurück und gibt im Allgemeinen eine Sammlung lesbarer Eigenschaften zurück, die vom Objekt definiert werden.

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

Aufrufparameter:

  • key: Zeichenfolge, nicht verwendet

Rückgabeergebnisse:

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