ObjetoXmlComentario

Los objetos XmlComment representan el contenido de los nodos de comentarios en el documento.

El nodo XmlComment representa un comentario en un documento XML. Usado porXmlCharacterDataEl atributo de datos heredado por la interfaz, o usando elXmlNodeEl atributo nodeValue heredado por la interfaz puede acceder al contenido de la anotación. (es decir, el texto entre ). Usado porXmlCharacterDataVarios métodos heredados de la interfaz pueden operar sobre el contenido de la anotación.

usarXmlDocument.createComment() para crear un objeto de anotación.

relación de herencia

propiedades de miembros

data

Cadena, el texto contenido en este nodo.

1
String XmlComment.data;

---

length

Entero, el número de caracteres contenidos en este nodo

1
readonly Integer XmlComment.length;

---

nodeType

Entero, devuelve el tipo de nodo del nodo.

1
readonly Integer XmlComment.nodeType;

El tipo de nodo de diferentes objetos devolverá valores diferentes:

• XmlElement: ELEMENT_NODE(1)
• XmlAttr:ATTRIBUTE_NODE(2)
• XmlText: TEXTO_NODO(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, devuelve el nombre del nodo, según su tipo

1
readonly String XmlComment.nodeName;

El nombre de nodo de diferentes objetos devolverá valores diferentes:

• XmlElement:nombre del elemento
• XmlAttr: Nombre del Atributo
• XmlText: #texto
• XmlCDATASection: #sección-cdata
• XmlProcessingInstruction: Devuelve el objetivo objetivo especificado
• XmlComment: #comentario
• XmlDocument: #documento
• XmlDocumentType: nombre del tipo de documento

---

nodeValue

String, devuelve el nombre del nodo, según su tipo

1
String XmlComment.nodeValue;

El nombre de nodo de diferentes objetos devolverá valores diferentes:

• XmlElement: nulo
• XmlAttr: valor de atributo
• XmlText: el contenido del nodo
• XmlCDATASection: el contenido del nodo
• XmlProcessingInstruction: Devuelve los datos de contenido especificados
• XmlComment: texto de anotación
• XmlDocument: nulo
• XmlDocumentType: nulo

---

ownerDocument

XmlDocument, devuelve el elemento raíz del nodo (XmlDocumentobjeto)

1
readonly XmlDocument XmlComment.ownerDocument;

---

parentNode

XmlNode, puede devolver el nodo padre de un nodo

1
readonly XmlNode XmlComment.parentNode;

---

childNodes

XmlNodeList, devuelve la lista de nodos secundarios del nodo especificado

1
readonly XmlNodeList XmlComment.childNodes;

---

children

XmlNodeList, devuelve la lista de nodos de los nodos de elementos secundarios del nodo especificado.

1
readonly XmlNodeList XmlComment.children;

---

firstChild

XmlNode, devuelve el primer nodo hijo del nodo

1
readonly XmlNode XmlComment.firstChild;

---

lastChild

XmlNode, devuelve el último nodo hijo del nodo

1
readonly XmlNode XmlComment.lastChild;

---

previousSibling

XmlNode, devuelve el nodo inmediatamente anterior a un nodo (en el mismo nivel de árbol). Si no existe tal nodo, esta propiedad devuelve nulo.

1
readonly XmlNode XmlComment.previousSibling;

---

nextSibling

XmlNode, devuelve el nodo inmediatamente después de un elemento (en el mismo nivel de árbol). Si no existe tal nodo, el atributo devuelve nulo.

1
readonly XmlNode XmlComment.nextSibling;

---

firstElementChild

XmlNode, devuelve el primer nodo elemento hijo del nodo

1
readonly XmlNode XmlComment.firstElementChild;

---

lastElementChild

XmlNode, devuelve el último nodo del elemento hijo del nodo

1
readonly XmlNode XmlComment.lastElementChild;

---

previousElementSibling

XmlNode, devuelve el nodo del elemento inmediatamente anterior a un nodo (en el mismo nivel de árbol). Si no existe tal nodo, esta propiedad devuelve nulo.

1
readonly XmlNode XmlComment.previousElementSibling;

---

nextElementSibling

XmlNode, devuelve el nodo del elemento inmediatamente después de un elemento (en el mismo nivel de árbol). Si no existe tal nodo, el atributo devuelve nulo.

1
readonly XmlNode XmlComment.nextElementSibling;

---

textContent

Cadena, consulta y establece el texto del elemento seleccionado. Al realizar la consulta, devuelve los valores de todos los nodos de texto dentro del nodo del elemento; al configurar, elimina todos los nodos secundarios y los reemplaza con un solo nodo de texto.

1
String XmlComment.textContent;

función miembro

substringData

Extraer subcadena del nodo

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

Parámetros de llamada:

• offset: Entero, la posición del primer carácter que se devolverá
• count: Entero, el número de caracteres de la subcadena que se devolverán

Resultados de devolución:

• String, devuelve la cadena extraída

---

appendData

Agregar cadena al nodo

1
XmlComment.appendData(String arg);

Parámetros de llamada:

• arg: Cadena, la cadena que se agregará al nodo

---

insertData

Insertar cadena en el nodo

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

Parámetros de llamada:

• offset: Entero, la posición del carácter en la que se insertará la cadena en el nodo
• arg: Cadena, la cadena a insertar

---

deleteData

Eliminar texto del nodo

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

Parámetros de llamada:

• offset: Entero, la posición del primer carácter que se eliminará
• count: Entero, el número de caracteres a eliminar

---

replaceData

Reemplace los caracteres del nodo con la cadena especificada

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

Parámetros de llamada:

• offset: Entero, la posición del carácter del nodo que se va a reemplazar
• count: Entero, el número de caracteres a reemplazar
• arg: Cadena, la cadena a insertar

---

hasChildNodes

Consultar si hay nodos secundarios

1
Boolean XmlComment.hasChildNodes();

Resultados de devolución:

• Boolean, devuelve verdadero si hay nodos secundarios; de lo contrario, devuelve falso

---

normalize

Fusionar nodos de texto adyacentes y eliminar nodos de texto vacíos

1
XmlComment.normalize();

Este método atravesará todos los nodos descendientes del nodo actual y normalizará el documento eliminando los nodos de Texto vacíos y fusionando todos los nodos de Texto adyacentes. Este método es útil para simplificar la estructura del árbol del documento después de insertar o eliminar nodos.

---

cloneNode

Crea una copia exacta del nodo especificado.

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

Parámetros de llamada:

• deep: booleano, si se realiza una copia profunda; cuando es verdadero, el nodo clonado clonará todos los nodos secundarios del nodo original

Resultados de devolución:

• XmlNode, devuelve el nodo copiado

Este método copiará y devolverá una copia del nodo en el que se llamó. Si el argumento que se le pasa es verdadero, también copiará recursivamente todos los nodos descendientes del nodo actual. De lo contrario, sólo copia el nodo actual. El nodo devuelto no pertenece al árbol del documento y su propiedad parentNode es nula. Cuando se copia un nodo Elemento, se copiarán todas sus propiedades.

---

lookupPrefix

Devuelve el prefijo que coincide con el URI del espacio de nombres especificado en el nodo actual

1
String XmlComment.lookupPrefix(String namespaceURI);

Parámetros de llamada:

• namespaceURI: Cadena, especifica el URI del espacio de nombres coincidente

Resultados de devolución:

• String, devuelve el prefijo coincidente, devuelve nulo si no coincide.

---

lookupNamespaceURI

Devuelve el URI del espacio de nombres que coincide con el prefijo especificado en el nodo actual

1
String XmlComment.lookupNamespaceURI(String prefix);

Parámetros de llamada:

• prefix: Cadena, especifica el prefijo coincidente

Resultados de devolución:

• String, devuelve el URI del espacio de nombres coincidente, devuelve nulo si no coincide.

---

insertBefore

Insertar un nuevo nodo secundario antes de un nodo secundario existente

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

Parámetros de llamada:

• newChild:XmlNode, insertar nuevo nodo
• refChild:XmlNode, inserte un nuevo nodo antes de este nodo

Resultados de devolución:

• XmlNode, devuelve el nuevo nodo hijo

Si newChild ya existe en el árbol de documentos, se eliminará del árbol de documentos y se reinsertará en su nueva posición. Los nodos de un documento (o los nodos creados por un documento) no se pueden insertar en otro documento. Es decir, el atributoownerDocument de newChild debe ser el mismo que el atributoownerDocument del nodo actual.

---

insertAfter

Insertar un nuevo nodo secundario después de un nodo secundario existente

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

Parámetros de llamada:

• newChild:XmlNode, insertar nuevo nodo
• refChild:XmlNode, inserte un nuevo nodo después de este nodo

Resultados de devolución:

• XmlNode, devuelve el nuevo nodo hijo

Si newChild ya existe en el árbol de documentos, se eliminará del árbol de documentos y se reinsertará en su nueva posición. Los nodos de un documento (o los nodos creados por un documento) no se pueden insertar en otro documento. Es decir, el atributoownerDocument de newChild debe ser el mismo que el atributoownerDocument del nodo actual.

---

appendChild

Agrega un nuevo nodo secundario al final de la lista de nodos secundarios de un nodo

1
XmlNode XmlComment.appendChild(XmlNode newChild);

Parámetros de llamada:

• newChild:XmlNode, especifique el nodo agregado

Resultados de devolución:

• XmlNode, devuelve este nuevo nodo hijo

Si newChild ya existe en el árbol de documentos, se eliminará del árbol de documentos y se reinsertará en su nueva posición. Los nodos de un documento (o los nodos creados por un documento) no se pueden insertar en otro documento. Es decir, el atributoownerDocument de newChild debe ser el mismo que el atributoownerDocument del nodo actual.

---

replaceChild

Reemplazar un nodo hijo por otro

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

Parámetros de llamada:

• newChild:XmlNode, especifique el nuevo nodo
• oldChild:XmlNode, especifica el nodo que se va a reemplazar

Resultados de devolución:

• XmlNodeSi el reemplazo es exitoso, este método puede devolver el nodo reemplazado, si el reemplazo falla, devuelve nulo.

Si newChild ya existe en el árbol de documentos, se eliminará del árbol de documentos y se reinsertará en su nueva posición. Los nodos de un documento (o los nodos creados por un documento) no se pueden insertar en otro documento. Es decir, el atributoownerDocument de newChild debe ser el mismo que el atributoownerDocument del nodo actual.

---

removeChild

Eliminar un nodo de la lista de nodos secundarios

1
XmlNode XmlComment.removeChild(XmlNode oldChild);

Parámetros de llamada:

• oldChild:XmlNode, especifica el nodo que se eliminará

Resultados de devolución:

• XmlNodeSi la eliminación es exitosa, este método puede devolver el nodo eliminado, si falla, devuelve nulo.

---

toString

Devuelve la representación de cadena del objeto. Generalmente, se devuelve "[Objeto nativo]". El objeto se puede volver a implementar de acuerdo con sus propias características.

1
String XmlComment.toString();

Resultados de devolución:

• String, devuelve la representación de cadena del objeto

---

toJSON

Devuelve una representación en formato JSON del objeto, que generalmente devuelve una colección de propiedades legibles definidas por el objeto.

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

Parámetros de llamada:

• key: Cadena, no utilizada

Resultados de devolución:

• Value, devuelve un valor que contiene JSON serializable