Objekt XmlComment

Das XmlComment-Objekt repräsentiert den Inhalt des Kommentarknotens im Dokument

Der XmlComment-Knoten repräsentiert einen Kommentar im XML-Dokument. Benutzt vonXmlCharacterData Das von der Schnittstelle geerbte Datenattribut oder verwenden Sie das XmlNodeDie von der Schnittstelle geerbte Eigenschaft nodeValue kann auf den Inhalt der Anmerkung zugreifen. (Das heißt, der Text dazwischen). Benutzt vonXmlCharacterData Verschiedene von der Schnittstelle geerbte Methoden können den Inhalt des Kommentars manipulieren.

benutzen XmlDocument.createComment(), um ein Kommentarobjekt zu erstellen.

Vererbungsbeziehung

Mitgliedsattribute

data

String, der im Knoten enthaltene Text

1
String XmlComment.data;

---

length

Ganzzahl, die Anzahl der im 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: Name des Anwesens
• XmlText: #text
• XmlCDATASection: # cdata-section
• XmlProcessingInstruction: Kehren Sie zum angegebenen Ziel zurück
• XmlComment: #Kommentar
• XmlDocument: #document
• XmlDocumentType: Doctype Name

---

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: 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 Stammelement des Knotens zurück (XmlDocument Objekt)

1
readonly XmlDocument XmlComment.ownerDocument;

---

parentNode

XmlNodeKann 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;

---

firstChild

XmlNode, Geben Sie den ersten untergeordneten Knoten des Knotens zurück

1
readonly XmlNode XmlComment.firstChild;

---

lastChild

XmlNode, Geben Sie den letzten untergeordneten Knoten des Knotens zurück

1
readonly XmlNode XmlComment.lastChild;

---

previousSibling

XmlNode, Gibt den Knoten unmittelbar vor einem bestimmten Knoten (auf derselben Baumebene) zurück. Wenn kein solcher Knoten vorhanden ist, gibt dieses Attribut null zurück

1
readonly XmlNode XmlComment.previousSibling;

---

nextSibling

XmlNode, Gibt den Knoten unmittelbar nach einem Element zurück (in derselben Baumebene). Wenn kein solcher Knoten vorhanden ist, gibt die Eigenschaft null zurück

1
readonly XmlNode XmlComment.nextSibling;

Mitgliedsfunktion

substringData

Teilzeichenfolge aus Knoten extrahieren

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

Parameter aufrufen:

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

Ergebnis zurückgeben:

• String, Geben Sie die extrahierte Zeichenfolge zurück

---

appendData

Hängen Sie die Zeichenfolge an den Knoten an

1
XmlComment.appendData(String arg);

Parameter aufrufen:

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

---

insertData

Fügen Sie eine Zeichenfolge in den Knoten ein

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

Parameter aufrufen:

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

---

deleteData

Text vom Knoten löschen

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

Parameter aufrufen:

• 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
XmlComment.replaceData(Integer offset,
    Integer count,
    String arg);

Parameter aufrufen:

• offset: Integer, die Zeichenposition des zu ersetzenden Knotens
• count: Integer, 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();

Ergebnis zurückgeben:

• Boolean, Geben Sie true zurück, wenn untergeordnete Knoten vorhanden sind, andernfalls false

---

normalize

Führen Sie benachbarte Textknoten zusammen und löschen Sie leere Textknoten

1
XmlComment.normalize();

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

Erstellen Sie eine genaue Kopie des angegebenen Knotens

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

Parameter aufrufen:

• deep: Boolean, ob tief kopiert werden soll, wenn true, klont der geklonte Knoten alle untergeordneten Knoten des ursprünglichen Knotens

Ergebnis zurückgeben:

• XmlNode, Geben Sie den kopierten Knoten zurück

Diese Methode kopiert eine Kopie des Knotens, der sie aufgerufen hat, und gibt sie zurück. Wenn der an ihn übergebene Parameter true 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 Eigenschaft parentNode 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 XmlComment.lookupPrefix(String namespaceURI);

Parameter aufrufen:

• namespaceURI: String, geben Sie den passenden Namespace-URI an

Ergebnis zurückgeben:

• String, Gibt das übereinstimmende Präfix zurück und 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);

Parameter aufrufen:

• prefix: String, geben Sie das passende Präfix an

Ergebnis zurückgeben:

• String, Gibt den übereinstimmenden Namespace-URI zurück und 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 XmlComment.insertBefore(XmlNode newChild,
    XmlNode refChild);

Parameter aufrufen:

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

Ergebnis zurückgeben:

• XmlNode, Geben Sie den neuen untergeordneten Knoten zurück

Wenn newChild bereits im Dokumentbaum vorhanden ist, wird es aus dem Dokumentbaum 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 nach dem vorhandenen untergeordneten Knoten einen neuen untergeordneten Knoten ein

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

Parameter aufrufen:

• newChild:: XmlNode, Fügen Sie einen neuen Knoten ein
• refChild:: XmlNodeFügen Sie nach diesem Knoten einen neuen Knoten ein

Ergebnis zurückgeben:

• XmlNode, Geben Sie den neuen untergeordneten Knoten zurück

Wenn newChild bereits im Dokumentbaum vorhanden ist, wird es aus dem Dokumentbaum 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.

---

appendChild

Fügen Sie am Ende der Liste der untergeordneten Knoten des Knotens einen neuen untergeordneten Knoten hinzu

1
XmlNode XmlComment.appendChild(XmlNode newChild);

Parameter aufrufen:

• newChild:: XmlNodeGeben Sie den hinzugefügten Knoten an

Ergebnis zurückgeben:

• XmlNode, Geben Sie diesen neuen untergeordneten Knoten zurück

Wenn newChild bereits im Dokumentbaum vorhanden ist, wird es aus dem Dokumentbaum 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.

---

replaceChild

Ersetzen Sie einen untergeordneten Knoten durch einen anderen

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

Parameter aufrufen:

• newChild:: XmlNode, Geben Sie einen neuen Knoten an
• oldChild:: XmlNodeGeben Sie den zu ersetzenden Knoten an

Ergebnis zurückgeben:

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

Wenn newChild bereits im Dokumentbaum vorhanden ist, wird es aus dem Dokumentbaum 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.

---

removeChild

Entfernen Sie einen Knoten aus der Liste der untergeordneten Knoten

1
XmlNode XmlComment.removeChild(XmlNode oldChild);

Parameter aufrufen:

• oldChild:: XmlNodeGeben 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 dies fehlschlägt, wird null zurückgegeben

---

toString

Gibt die Zeichenfolgendarstellung des Objekts zurück, gibt im Allgemeinen "[Native Object]" zurück. Das Objekt kann gemäß seinen eigenen Merkmalen erneut implementiert werden

1
String XmlComment.toString();

Ergebnis zurückgeben:

• String, Gibt die Zeichenfolgendarstellung des Objekts zurück

---

toJSON

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

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

Parameter aufrufen:

• key: String, unbenutzt

Ergebnis zurückgeben:

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