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.
utilisation XmlDocument.createComment() pour créer un objet de commentaire.
Héritage
Attributs des membres
data
String, le texte contenu dans le nœud
1String 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
1readonly 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
1String 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
2String 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 de la sous-chaîne à renvoyer
Résultat de retour :
- String, Renvoie la chaîne extraite
appendData
Ajouter la chaîne au nœud
1XmlComment.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
2XmlComment.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
3XmlComment.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
1Boolean 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 nœuds 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é
1XmlNode 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
1String 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
1String 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
2XmlNode XmlComment.insertBefore(XmlNode newChild,
XmlNode refChild);
Paramètres d'appel :
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
2XmlNode XmlComment.insertAfter(XmlNode newChild,
XmlNode refChild);
Paramètres d'appel :
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.
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
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.
replaceChild
Remplacer un nœud enfant par un autre
1
2XmlNode XmlComment.replaceChild(XmlNode newChild,
XmlNode oldChild);
Paramètres d'appel :
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
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.
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
1String 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
1Value XmlComment.toJSON(String key = "");
Paramètres d'appel :
- key: chaîne, inutilisé
Résultat de retour :
- Value, Renvoie une valeur contenant JSON sérialisable