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.

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

Erbe

Mitgliedsattribute

data

String, der im Knoten enthaltene Text

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

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

nodeValue

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

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

1
XmlComment.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
2
XmlComment.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
XmlComment.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 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 delete

1XmlComment.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 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 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 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

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

insertAfter

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

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

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

replaceChild

Ersetzen Sie einen untergeordneten Knoten durch einen anderen

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

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

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

1
Value XmlComment.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 XmlComment

Erbe

Mitgliedsattribute

data

length

nodeType

nodeName

nodeValue

ownerDocument

parentNode

childNodes

firstChild

lastChild

previousSibling

nextSibling

Mitgliederfunktion

substringData

appendData

insertData

deleteData

replaceData

hasChildNodes

normalize

cloneNode

lookupPrefix

lookupNamespaceURI

insertBefore

insertAfter

appendChild

replaceChild

removeChild

toString

toJSON