Objekt XmlComment
Das XmlComment-Objekt repräsentiert den Inhalt des Kommentarknotens im Dokument
Der XmlComment-Knoten stellt einen Kommentar im XML-Dokument dar. Benutzt vonXmlCharacterData Das von der Schnittstelle geerbte Datenattribut oder die XmlNodeDie von der Schnittstelle geerbte Eigenschaft nodeValue kann auf den Inhalt der Annotation zugreifen. (D.h. der Text dazwischen). Benutzt vonXmlCharacterData Verschiedene von der Schnittstelle geerbte Methoden können den Inhalt des Kommentars manipulieren.
verwenden XmlDocument.createComment(), um ein Kommentarobjekt zu erstellen.
Nachlass
Mitgliedsattribute
data
String, der im Knoten enthaltene Text
1String XmlComment.data;
length
Integer, die Anzahl der im Knoten enthaltenen Zeichen
1readonly Integer XmlComment.length;
nodeType
Integer, gibt den Knotentyp des Knotens zurück
1readonly Integer XmlComment.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 XmlComment.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 XmlComment.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 XmlComment.ownerDocument;
parentNode
XmlNode, Kann den Elternknoten eines Knotens zurückgeben
1readonly XmlNode XmlComment.parentNode;
childNodes
XmlNodeList, Gibt die Knotenliste der Kindknoten des angegebenen Knotens zurück
1readonly XmlNodeList XmlComment.childNodes;
firstChild
XmlNode, Gibt den ersten untergeordneten Knoten des Knotens zurück
1readonly XmlNode XmlComment.firstChild;
lastChild
XmlNode, Den letzten untergeordneten Knoten des Knotens zurückgeben
1readonly XmlNode XmlComment.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 XmlComment.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 XmlComment.nextSibling;
Mitgliederfunktion
substringData
Teilstring aus Knoten extrahieren
1
2String XmlComment.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
1XmlComment.appendData(String arg);
Aufrufparameter:
- arg: String, der an den Knoten anzuhängende String
insertData
String in Knoten einfügen
1
2XmlComment.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
2XmlComment.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
3XmlComment.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 XmlComment.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
1XmlComment.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 XmlComment.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 XmlComment.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 XmlComment.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 XmlComment.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 XmlComment.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 XmlComment.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 XmlComment.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 XmlComment.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 XmlComment.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 XmlComment.toJSON(String key = "");
Aufrufparameter:
- key: String, unbenutzt
Ergebnis zurückgeben:
- Value, Gibt einen Wert zurück, der JSON serialisierbar enthält