ObjectXmlComment

XmlComment-Objekte repräsentieren den Inhalt von Kommentarknoten im Dokument

Der XmlComment-Knoten repräsentiert einen Kommentar in einem XML-Dokument. Benutzt vonXmlCharacterDataDas von der Schnittstelle geerbte oder verwendete DatenattributXmlNodeDas von der Schnittstelle geerbte Attribut nodeValue kann auf den Inhalt der Annotation zugreifen. (d. h. der Text zwischen ). Benutzt vonXmlCharacterDataVerschiedene von der Schnittstelle geerbte Methoden können den Inhalt der Anmerkung bearbeiten.

verwendenXmlDocument.createComment(), um ein Anmerkungsobjekt zu erstellen.

Erbschaftsverhältnis

Mitgliedereigenschaften

data

String, der in diesem Knoten enthaltene Text

1
String XmlComment.data;

---

length

Ganzzahl, die Anzahl der in diesem Knoten enthaltenen Zeichen

1
readonly Integer XmlComment.length;

---

nodeType

Ganzzahl, gibt den Knotentyp des Knotens zurück

1
readonly Integer XmlComment.nodeType;

Der Knotentyp 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 XmlComment.nodeName;

Der Knotenname verschiedener Objekte gibt unterschiedliche Werte zurück:

• XmlElement:Elementname
• XmlAttr: Attributname
• XmlText: #text
• XmlCDATASection: #cdata-Abschnitt
• XmlProcessingInstruction: Gibt das angegebene Ziel zurück
• XmlComment: #Kommentar
• XmlDocument: #dokumentieren
• XmlDocumentType: Name des Dokumenttyps

---

nodeValue

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

1
String XmlComment.nodeValue;

Der Knotenname verschiedener Objekte gibt unterschiedliche Werte zurück:

• XmlElement: Null
• XmlAttr: Attributwert
• XmlText: der Inhalt des Knotens
• XmlCDATASection: der Inhalt des Knotens
• XmlProcessingInstruction: Gibt die angegebenen Inhaltsdaten zurück
• XmlComment: Anmerkungstext
• XmlDocument: Null
• XmlDocumentType: Null

---

ownerDocument

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

1
readonly XmlDocument XmlComment.ownerDocument;

---

parentNode

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

1
readonly XmlNode XmlComment.parentNode;

---

childNodes

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

1
readonly XmlNodeList XmlComment.childNodes;

---

children

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

1
readonly XmlNodeList XmlComment.children;

---

firstChild

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

1
readonly XmlNode XmlComment.firstChild;

---

lastChild

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

1
readonly XmlNode XmlComment.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 XmlComment.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 XmlComment.nextSibling;

---

firstElementChild

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

1
readonly XmlNode XmlComment.firstElementChild;

---

lastElementChild

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

1
readonly XmlNode XmlComment.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 XmlComment.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 XmlComment.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 XmlComment.textContent;

Mitgliedsfunktion

substringData

Teilzeichenfolge aus Knoten extrahieren

1
2
String XmlComment.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
XmlComment.appendData(String arg);

Aufrufparameter:

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

---

insertData

Zeichenfolge in Knoten einfügen

1
2
XmlComment.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
XmlComment.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
XmlComment.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 XmlComment.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
XmlComment.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 XmlComment.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 XmlComment.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 XmlComment.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 XmlComment.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 XmlComment.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 XmlComment.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 XmlComment.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 XmlComment.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 XmlComment.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 XmlComment.toJSON(String key = "");

Aufrufparameter:

• key: Zeichenfolge, nicht verwendet

Rückgabeergebnisse:

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