Objet XmlComment

L'objet XmlComment représente le contenu du nœud de commentaire dans le document

Le nœud XmlComment représente un commentaire dans le document XML. Utilisé parXmlCharacterData L'attribut de données hérité par l'interface, ou utilisez le XmlNodeLa propriété nodeValue héritée par l'interface peut accéder au contenu de l'annotation. (c'est-à-dire le texte entre). Utilisé parXmlCharacterData Différentes méthodes héritées de l'interface peuvent manipuler le contenu du commentaire.

utiliser XmlDocument.createComment() pour créer un objet de commentaire.

Héritage

Attributs des membres

data

String, le texte contenu dans le nœud

1
String XmlComment.data;

length

Entier, le nombre de caractères contenus dans le nœud

1readonly Integer XmlComment.length;

nodeType

Entier, renvoie le type de nœud du nœud

1readonly Integer XmlComment.nodeType;

Le nodeType de différents objets renverra différentes valeurs :

XmlElement: ELEMENT_NODE(1)
XmlAttr: ATTRIBUT_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, renvoie le nom du nœud, selon son type

1
readonly String XmlComment.nodeName;

Le nodeName de différents objets renverra différentes valeurs :

XmlElement: nom de l'élément
XmlAttr: Nom de la propriété
XmlText: #texte
XmlCDATASection: #cdata-section
XmlProcessingInstruction: Retour à la cible spécifiée
XmlComment: #commenter
XmlDocument: #document
XmlDocumentType: nom du type de document

nodeValue

String, renvoie le nom du nœud, selon son type

1
String XmlComment.nodeValue;

Le nodeName de différents objets renverra différentes valeurs :

XmlElement: nul
XmlAttr: La valeur de l'attribut
XmlText: Le contenu du nœud
XmlCDATASection: Le contenu du nœud
XmlProcessingInstruction: renvoie les données de contenu spécifiées
XmlComment: texte du commentaire
XmlDocument: nul
XmlDocumentType: nul

ownerDocument

XmlDocument, Renvoie l'élément racine du nœud (XmlDocument Objet)

1readonly XmlDocument XmlComment.ownerDocument;

parentNode

XmlNode, Peut renvoyer le nœud parent d'un nœud

1readonly XmlNode XmlComment.parentNode;

childNodes

XmlNodeList, Renvoie la liste des nœuds des nœuds enfants du nœud spécifié

1readonly XmlNodeList XmlComment.childNodes;

firstChild

XmlNode, Renvoie le premier nœud enfant du nœud

1readonly XmlNode XmlComment.firstChild;

lastChild

XmlNode, Renvoie le dernier nœud enfant du nœud

1readonly XmlNode XmlComment.lastChild;

previousSibling

XmlNode, Renvoie le nœud immédiatement avant un certain nœud (au même niveau d'arborescence), s'il n'y a pas de tel nœud, alors l'attribut renvoie null

1readonly XmlNode XmlComment.previousSibling;

nextSibling

XmlNode, Renvoie le nœud suivant immédiatement un élément (dans le même niveau d'arborescence), s'il n'y a pas de tel nœud, la propriété renvoie null

1readonly XmlNode XmlComment.nextSibling;

Fonction membre

substringData

Extraire la sous-chaîne du nœud

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

Paramètres d'appel :

offset: Entier, la position du premier caractère à retourner
count: Entier, le nombre de caractères dans la sous-chaîne à renvoyer

Résultat de retour :

String, Renvoie la chaîne extraite

appendData

Ajouter la chaîne au nœud

1
XmlComment.appendData(String arg);

Paramètres d'appel :

arg: String, la chaîne à ajouter au nœud

insertData

Insérer une chaîne dans le nœud

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

Paramètres d'appel :

offset: Entier, la position du caractère où la chaîne doit être insérée dans le nœud
arg: String, la chaîne à insérer

deleteData

Supprimer le texte du nœud

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

Paramètres d'appel :

offset: Entier, la position du premier caractère à supprimer
count: Entier, le nombre de caractères à supprimer

replaceData

Remplacer les caractères du nœud par la chaîne spécifiée

1
2
3
XmlComment.replaceData(Integer offset,
    Integer count,
    String arg);

Paramètres d'appel :

offset: Entier, la position du caractère du nœud à remplacer
count: Entier, le nombre de caractères à remplacer
arg: String, la chaîne à insérer

hasChildNodes

Demander s'il y a des nœuds enfants

1
Boolean XmlComment.hasChildNodes();

Résultat de retour :

Boolean, Renvoie true s'il y a des nœuds enfants, sinon renvoie false

normalize

Fusionner les nœuds de texte adjacents et supprimer les nœuds de texte vides

1XmlComment.normalize();

Cette méthode traversera tous les descendants du nœud actuel et normalisera le document en supprimant le nœud Text vide et en fusionnant tous les nœuds Text adjacents. Cette méthode est utile pour simplifier la structure de l'arborescence du document après l'insertion ou la suppression de nœuds.

cloneNode

Créer une copie exacte du nœud spécifié

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

Paramètres d'appel :

deep: booléen, s'il faut copier en profondeur, si vrai, le nœud cloné clonera tous les nœuds enfants du nœud d'origine

Résultat de retour :

XmlNode, Renvoie le nœud copié

Cette méthode copiera et renverra une copie du nœud qui l'a appelée. Si le paramètre qui lui est passé est vrai, il copiera également de manière récursive tous les descendants du nœud actuel. Sinon, il ne copie que le nœud courant. Le nœud renvoyé n'appartient pas à l'arborescence du document et sa propriété parentNode est nulle. Lorsque le nœud Element est copié, tous ses attributs seront copiés.

lookupPrefix

Renvoie le préfixe correspondant à l'URI d'espace de noms spécifié sur le nœud actuel

1
String XmlComment.lookupPrefix(String namespaceURI);

Paramètres d'appel :

namespaceURI: chaîne, spécifiez l'URI de l'espace de noms correspondant

Résultat de retour :

String, Renvoie le préfixe correspondant, renvoie null s'il ne correspond pas

lookupNamespaceURI

Renvoie l'URI de l'espace de noms qui correspond au préfixe spécifié sur le nœud actuel

1
String XmlComment.lookupNamespaceURI(String prefix);

Paramètres d'appel :

prefix: chaîne, spécifiez le préfixe correspondant

Résultat de retour :

String, Renvoie l'URI de l'espace de noms correspondant, renvoie null s'il ne correspond pas

insertBefore

Insérer un nouveau nœud enfant avant le nœud enfant existant

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

Paramètres d'appel :

newChild: XmlNode, Insérer un nouveau nœud
refChild: XmlNode, Insérer un nouveau nœud avant ce nœud

Résultat de retour :

XmlNode, Renvoie le nouveau nœud enfant

Si newChild existe déjà dans l'arborescence du document, il sera supprimé de l'arborescence du document, puis réinséré dans sa nouvelle position. Les nœuds d'un document (ou les nœuds créés par un document) ne peuvent pas être insérés dans un autre document. En d'autres termes, la propriété ownerDocument de newChild doit être la même que la propriété ownerDocument du nœud actuel.

insertAfter

Insérer un nouveau nœud enfant après le nœud enfant existant

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

Paramètres d'appel :

newChild: XmlNode, Insérer un nouveau nœud
refChild: XmlNode, Insérer un nouveau nœud après ce nœud

Résultat de retour :

XmlNode, Renvoie le nouveau nœud enfant

appendChild

Ajouter un nouveau nœud enfant à la fin de la liste des nœuds enfants du nœud

1XmlNode XmlComment.appendChild(XmlNode newChild);

Paramètres d'appel :

newChild: XmlNode, Spécifiez le nœud ajouté

Résultat de retour :

XmlNode, Renvoie ce nouveau nœud enfant

replaceChild

Remplacer un nœud enfant par un autre

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

Paramètres d'appel :

newChild: XmlNode, Spécifiez un nouveau nœud
oldChild: XmlNode, Spécifiez le nœud à remplacer

Résultat de retour :

XmlNode, Si le remplacement réussit, cette méthode peut renvoyer le nœud remplacé, si le remplacement échoue, elle renvoie null

removeChild

Supprimer un nœud de la liste des nœuds enfants

1XmlNode XmlComment.removeChild(XmlNode oldChild);

Paramètres d'appel :

oldChild: XmlNode, Spécifiez le nœud à supprimer

Résultat de retour :

XmlNode, Si la suppression réussit, cette méthode peut renvoyer le nœud supprimé, si elle échoue, elle renvoie null

toString

Renvoie la représentation sous forme de chaîne de l'objet, renvoie généralement "[Objet natif]", l'objet peut être ré-implémenté selon ses propres caractéristiques

1
String XmlComment.toString();

Résultat de retour :

String, Renvoie la représentation sous forme de chaîne de l'objet

toJSON

Renvoie la représentation au format JSON de l'objet, renvoie généralement une collection d'attributs lisibles définis par l'objet

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

Paramètres d'appel :

key: chaîne, inutilisé

Résultat de retour :

Value, Renvoie une valeur contenant JSON sérialisable

Guide de développement

Module de base

Objets intégrés

Module communautaire

Objet XmlComment

Héritage

Attributs des membres

data

length

nodeType

nodeName

nodeValue

ownerDocument

parentNode

childNodes

firstChild

lastChild

previousSibling

nextSibling

Fonction membre

substringData

appendData

insertData

deleteData

replaceData

hasChildNodes

normalize

cloneNode

lookupPrefix

lookupNamespaceURI

insertBefore

insertAfter

appendChild

replaceChild

removeChild

toString

toJSON