ObjetoXmlTexto
Un objeto XmlText representa el contenido de texto de un elemento o atributo
El nodo XmlText representa una secuencia de texto sin formato en un documento XML. Dado que el texto sin formato aparece en elementos y atributos XML, el nodo XmlText suele estarXmlElementsuma de nodosXmlAttrAparecen los hijos del nodo.
Los nodos XmlText heredanXmlCharacterDatainterfaz, a través deXmlCharacterDataatributo de datos heredado de la interfaz o deXmlNodeEl atributo nadevalue heredado por la interfaz puede acceder al contenido de texto del nodo XmlText.
uso deXmlCharacterDataLos métodos heredados o el método splitText() definido por la propia interfaz XmlText pueden operar nodos XmlText. usarXmlDocumentcreateTextNode para crear un nuevo nodo XmlText.
El nodo XmlText no tiene nodos secundarios.
Para conocer los métodos para eliminar nodos XmlText vacíos y fusionar nodos XmlText adyacentes de un subárbol de un documento, consulteXmlNode.normalizemétodo.
relación de herencia
propiedades de miembros
data
Cadena, el texto contenido en este nodo.
1String XmlText.data;
length
Entero, el número de caracteres contenidos en este nodo
1readonly Integer XmlText.length;
nodeType
Entero, devuelve el tipo de nodo del nodo.
1readonly Integer XmlText.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
1readonly String XmlText.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
1String XmlText.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)
1readonly XmlDocument XmlText.ownerDocument;
parentNode
XmlNode, puede devolver el nodo padre de un nodo
1readonly XmlNode XmlText.parentNode;
childNodes
XmlNodeList, devuelve la lista de nodos secundarios del nodo especificado
1readonly XmlNodeList XmlText.childNodes;
children
XmlNodeList, devuelve la lista de nodos de los nodos de elementos secundarios del nodo especificado.
1readonly XmlNodeList XmlText.children;
firstChild
XmlNode, devuelve el primer nodo hijo del nodo
1readonly XmlNode XmlText.firstChild;
lastChild
XmlNode, devuelve el último nodo hijo del nodo
1readonly XmlNode XmlText.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.
1readonly XmlNode XmlText.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.
1readonly XmlNode XmlText.nextSibling;
firstElementChild
XmlNode, devuelve el primer nodo elemento hijo del nodo
1readonly XmlNode XmlText.firstElementChild;
lastElementChild
XmlNode, devuelve el último nodo del elemento hijo del nodo
1readonly XmlNode XmlText.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.
1readonly XmlNode XmlText.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.
1readonly XmlNode XmlText.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.
1String XmlText.textContent;
función miembro
splitText
Divida el nodo de texto en dos nodos según el desplazamiento especificado
1XmlText XmlText.splitText(Integer offset);
Parámetros de llamada:
- offset: Entero, especifica dónde dividir los nodos de texto. El valor inicial comienza con 0.
Resultados de devolución:
- XmlText, Nodo de texto dividido del nodo actual
Este método dividirá el nodo XmlText en dos nodos en el desplazamiento especificado. El nodo XmlText original se modificará para que contenga el contenido de texto antes (pero sin incluir) el contenido de texto en la posición especificada por el desplazamiento. Se creará un nuevo nodo XmlText para almacenar todos los caracteres desde la posición de desplazamiento (incluidos los caracteres en esta posición) hasta el final del carácter original. El nuevo nodo XmlText es el valor de retorno de este método. Además, si el nodo XmlText original tiene un parentNode, el nuevo nodo XmlText se insertará en este nodo principal, inmediatamente después del nodo original.
XmlCDATASectionLa interfaz hereda la interfaz XmlText,XmlCDATASectionLos nodos también pueden usar este método, pero los nodos recién creados sonXmlCDATASectionnodo en lugar de un nodo XmlText.
substringData
Extraer subcadena del nodo
1
2String XmlText.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
1XmlText.appendData(String arg);
Parámetros de llamada:
- arg: Cadena, la cadena que se agregará al nodo
insertData
Insertar cadena en el nodo
1
2XmlText.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
2XmlText.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
3XmlText.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
1Boolean XmlText.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
1XmlText.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.
1XmlNode XmlText.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
1String XmlText.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
1String XmlText.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
2XmlNode XmlText.insertBefore(XmlNode newChild,
XmlNode refChild);
Parámetros de llamada:
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
2XmlNode XmlText.insertAfter(XmlNode newChild,
XmlNode refChild);
Parámetros de llamada:
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
1XmlNode XmlText.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
2XmlNode XmlText.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
1XmlNode XmlText.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.
1String XmlText.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.
1Value XmlText.toJSON(String key = "");
Parámetros de llamada:
- key: Cadena, no utilizada
Resultados de devolución:
- Value, devuelve un valor que contiene JSON serializable