Objeto XmlElement

Los objetos XmlElement representan elementos en documentos XML

Herencia

Atributos de miembros

namespaceURI

Cadena, el URI del espacio de nombres del elemento de consulta. Si el nodo seleccionado no tiene espacio de nombres, este atributo devuelve NULL

1
readonly String XmlElement.namespaceURI;

prefix

Cadena, consulta y establece el prefijo del espacio de nombres del elemento. Si el nodo seleccionado no tiene espacio de nombres, este atributo devuelve NULL

1
String XmlElement.prefix;

localName

Cadena, el nombre local del elemento de consulta. Si el nodo seleccionado no tiene espacio de nombres, este atributo es equivalente a nodeName

1
readonly String XmlElement.localName;

tagName

Cadena, devuelve el nombre de etiqueta del elemento.

1
readonly String XmlElement.tagName;

id

Cadena, consulta y establece el atributo id del elemento.

1
String XmlElement.id;

textContent

Cadena, consulta y configura el texto del elemento seleccionado. Al realizar una consulta, devuelve los valores de todos los nodos de texto en el nodo del elemento; al configurar, elimina todos los nodos secundarios y reemplázalos con un solo nodo de texto.

1
String XmlElement.textContent;

innerHTML

Cadena, consulta y configura el texto HTML del elemento seleccionado, solo válido en modo html. Al consultar, devuelva los códigos HTML de todos los nodos secundarios en el nodo del elemento; al configurar, elimine todos los nodos secundarios y reemplácelos con el HTML especificado después de la decodificación.

1
String XmlElement.innerHTML;

className

Cadena, consulta y establece el atributo de clase del elemento, solo válido en modo html

1
String XmlElement.className;

attributes

XmlNamedNodeMap , devuelve NamedNodeMap que contiene los atributos del nodo seleccionado. Si el nodo seleccionado no es un elemento, este atributo devuelve NULL.

1
readonly XmlNamedNodeMap XmlElement.attributes;

nodeType

Entero, devuelve el tipo de nodo del nodo

1
readonly Integer XmlElement.nodeType;

El nodeType de diferentes objetos devolverá diferentes valores:

• XmlElement : ELEMENT_NODE (1)
• XmlAttr : XmlAttr (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

Cadena, devuelve el nombre del nodo, según su tipo.

1
readonly String XmlElement.nodeName;

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

• XmlElement : nombre del elemento
• XmlAttr : nombre de atributo
• XmlText : #text
• XmlCDATASection : # cdata-section
• XmlProcessingInstruction : devuelve el destino especificado
• XmlComment : #comment
• XmlDocument : #document
• XmlDocumentType : nombre del tipo de documento

nodeValue

Cadena, devuelve el nombre del nodo, según su tipo.

1
String XmlElement.nodeValue;

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

• XmlElement : nulo
• XmlAttr : el valor del atributo
• XmlText : el contenido del nodo
• XmlCDATASection : el contenido del nodo
• XmlProcessingInstruction : Devuelve los datos del contenido especificado
• XmlComment : texto del comentario
• XmlDocument : nulo
• XmlDocumentType : nulo

ownerDocument

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

1
readonly XmlDocument XmlElement.ownerDocument;

parentNode

XmlNode , puede devolver el nodo padre de un nodo

1
readonly XmlNode XmlElement.parentNode;

childNodes

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

1
readonly XmlNodeList XmlElement.childNodes;

firstChild

XmlNode , devuelve el primer nodo hijo del nodo

1
readonly XmlNode XmlElement.firstChild;

lastChild

XmlNode , devuelve el último nodo hijo del nodo

1
readonly XmlNode XmlElement.lastChild;

previousSibling

XmlNode , devuelve el nodo inmediatamente antes de un nodo (en el mismo nivel de árbol), si no existe tal nodo, este atributo devuelve nulo

1
readonly XmlNode XmlElement.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 XmlElement.nextSibling;

Función miembro

getAttribute

Consultar el valor de un atributo por nombre

1
String XmlElement.getAttribute(String name);

Parámetros de llamada:

• name : Cadena, especifique el nombre del atributo de la consulta

Devolver resultado:

• String , devuelve el valor de la propiedad.

getAttributeNS

Obtener valor de atributo por URI de espacio de nombres y nombre

1
2
String XmlElement.getAttributeNS(String namespaceURI,
    String localName);

Parámetros de llamada:

• namespaceURI : String, especifica el URI del espacio de nombres de la consulta
• localName : String, especifique el nombre de la propiedad a consultar

Devolver resultado:

• String , devuelve el valor de la propiedad.

setAttribute

Crear o cambiar una nueva propiedad

1
2
XmlElement.setAttribute(String name,
    String value);

Parámetros de llamada:

• name : String, especifique el nombre de la propiedad a establecer
• value : Cadena, especifique el valor del atributo que se establecerá

Este método establece el atributo especificado en el valor especificado. Si no hay ningún atributo con el nombre especificado, el método creará un nuevo atributo

setAttributeNS

Crear o cambiar atributos con espacio de nombres

1
2
3
XmlElement.setAttributeNS(String namespaceURI,
    String qualifiedName,
    String value);

Parámetros de llamada:

• namespaceURI : String, especifica el URI del espacio de nombres que se establecerá
• qualifiedName : String, especifique el nombre del atributo que se establecerá
• value : Cadena, especifique el valor del atributo que se establecerá

Este método es similar al método setAttribute, excepto que el atributo que se va a crear o establecer se especifica mediante el URI del espacio de nombres y el nombre calificado (que consta del prefijo del espacio de nombres, los dos puntos y el nombre local en el espacio de nombres). Además de cambiar el valor de un atributo, el uso de este método también puede cambiar el prefijo del espacio de nombres del atributo

removeAttribute

Eliminar el atributo especificado por nombre

1
XmlElement.removeAttribute(String name);

Parámetros de llamada:

• name : Cadena, especifique el nombre del atributo eliminado

removeAttributeNS

Eliminar atributos especificados por espacio de nombres y nombre

1
2
XmlElement.removeAttributeNS(String namespaceURI,
    String localName);

Parámetros de llamada:

• namespaceURI : String, especifica el URI del espacio de nombres que se eliminará
• localName : String, especifique el nombre del atributo eliminado

hasAttribute

Consultar si el nodo actual tiene un atributo con el nombre especificado

1
Boolean XmlElement.hasAttribute(String name);

Parámetros de llamada:

• name : Cadena, especifique el nombre del atributo de consulta

Devolver resultado:

• Boolean , si el nodo del elemento actual tiene el atributo especificado, devuelve verdadero, de lo contrario devuelve falso

hasAttributeNS

Consultar si el nodo actual tiene atributos del espacio de nombres y el nombre especificados

1
2
Boolean XmlElement.hasAttributeNS(String namespaceURI,
    String localName);

Parámetros de llamada:

• namespaceURI : String, especifique el URI del espacio de nombres que se consultará
• localName : String, especifique el nombre del atributo de consulta

Devolver resultado:

• Boolean , si el nodo del elemento actual tiene el atributo especificado, devuelve verdadero, de lo contrario devuelve falso

getElementsByTagName

Devuelve un XmlNodeList de todos los elementos con el nombre especificado

1
XmlNodeList XmlElement.getElementsByTagName(String tagName);

Parámetros de llamada:

• tagName : String, el nombre de la etiqueta que se va a recuperar. El valor "*" coincide con todas las etiquetas

Devolver resultado:

• XmlNodeList , un XmlNodeList colección de nodos XmlElement con etiquetas especificadas en el árbol de nodos. El orden de los nodos de elementos devueltos es el orden en el que aparecen en el documento de origen.

Este método atravesar los nodos descendientes del elemento especificado y devolver una XmlNodeList objeto de nodo XmlElement, que representa a todos los elementos del documento con el nombre de etiqueta especificada. El orden de los elementos en la matriz devuelta es el orden en el que aparecen en el código fuente del documento.

XmlDocument interfaz XmlDocument también define el método getElementsByTagName, que es similar a este método, pero atraviesa todo el documento en lugar de atravesar los descendientes de un elemento.

getElementsByTagNameNS

Devuelve un XmlNodeList de todos los elementos con el espacio de nombres y el nombre especificados

1
2
XmlNodeList XmlElement.getElementsByTagNameNS(String namespaceURI,
    String localName);

Parámetros de llamada:

• namespaceURI : String, especifique el URI del espacio de nombres que se consultará
• localName : String, el nombre de la etiqueta que se va a recuperar. El valor "*" coincide con todas las etiquetas

Devolver resultado:

• XmlNodeList , un XmlNodeList colección de nodos XmlElement con etiquetas especificadas en el árbol de nodos. El orden de los nodos de elementos devueltos es el orden en el que aparecen en el documento de origen.

Este método es similar al método getElementsByTagName, excepto que el nombre de etiqueta del elemento que desea obtener se especifica como una combinación del URI del espacio de nombres y el nombre local definido en el espacio de nombres.

getElementById

Devuelve el elemento con el atributo id especificado.

1
XmlElement XmlElement.getElementById(String id);

Parámetros de llamada:

• id : String, id a recuperar

Devolver resultado:

• XmlElement , el nodo XmlElement con el atributo id especificado en el árbol de nodos

Este método atravesará los nodos descendientes del elemento especificado y devolverá un objeto de nodo XmlElement que representa el primer elemento del documento con el atributo id especificado. .

XmlDocument interfaz XmlDocument también define el método getElementsByTagName, que es similar a este método, pero atraviesa todo el documento en lugar de atravesar los descendientes de un elemento.

getElementsByClassName

Devuelve una lista de nodos de todos los elementos con el nombre de clase especificado

1
XmlNodeList XmlElement.getElementsByClassName(String className);

Parámetros de llamada:

• className : String, el nombre de la clase a recuperar

Devolver resultado:

• XmlNodeList , la XmlNodeList colección de nodos XmlElement con el nombre de clase especificado en la estructura del documento. El orden de los nodos de elementos devueltos es el orden en el que aparecen en el documento de origen.

Este método devolverá un objeto XmlNodeList (que se puede procesar como una matriz de solo lectura), que almacena todos los nodos XmlElement con el nombre de clase especificado en el documento. El orden en el que se almacenan es el orden en que aparecen en el documento fuente. XmlNodeList objeto XmlNodeList está "en vivo", es decir, si un elemento con un nombre de etiqueta especificado se agrega o elimina en el documento, su contenido se actualizará automáticamente según sea necesario.

hasChildNodes

Consultar si hay nodos secundarios

1
Boolean XmlElement.hasChildNodes();

Devolver resultado:

• 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
XmlElement.normalize();

Este método atravesará todos los descendientes del nodo actual y normalizará el documento eliminando el nodo de texto vacío 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 XmlElement.cloneNode(Boolean deep = true);

Parámetros de llamada:

• deep : booleano, ya sea para realizar una copia profunda, cuando es verdadero, el nodo clonado clonará todos los nodos secundarios del nodo original

Devolver resultado:

• XmlNode , devuelve el nodo copiado

Este método copiará y devolverá una copia del nodo que lo llamó. Si el parámetro que se le pasa es verdadero, también copiará de forma recursiva todos los descendientes del nodo actual. De lo contrario, solo copia el nodo actual. El nodo devuelto no pertenece al árbol del documento y su propiedad parentNode es nula. Cuando se copia el nodo Elemento, se copiarán todos sus atributos.

lookupPrefix

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

1
String XmlElement.lookupPrefix(String namespaceURI);

Parámetros de llamada:

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

Devolver resultado:

• 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 XmlElement.lookupNamespaceURI(String prefix);

Parámetros de llamada:

• prefix : Cadena, especifique el prefijo coincidente

Devolver resultado:

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

insertBefore

Inserte un nuevo nodo secundario antes del nodo secundario existente

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

Parámetros de llamada:

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

Devolver resultado:

• XmlNode , devuelve el nuevo nodo hijo

Si newChild ya existe en el árbol del documento, se eliminará del árbol del documento y luego se volverá a insertar en su nueva posición. Los nodos de un documento (o los nodos creados por un documento) no se pueden insertar en otro documento. En otras palabras, la propiedad ownerDocument de newChild debe ser la misma que la propiedad ownerDocument del nodo actual.

insertAfter

Inserte un nuevo nodo secundario después del nodo secundario existente

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

Parámetros de llamada:

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

Devolver resultado:

• XmlNode , devuelve el nuevo nodo hijo

Si newChild ya existe en el árbol del documento, se eliminará del árbol del documento y luego se volverá a insertar en su nueva posición. Los nodos de un documento (o los nodos creados por un documento) no se pueden insertar en otro documento. En otras palabras, la propiedad ownerDocument de newChild debe ser la misma que la propiedad ownerDocument del nodo actual.

appendChild

Agregue un nuevo nodo secundario al final de la lista de nodos secundarios del nodo.

1
XmlNode XmlElement.appendChild(XmlNode newChild);

Parámetros de llamada:

• newChild : XmlNode , especifique el nodo agregado

Devolver resultado:

• XmlNode , devuelve este nuevo nodo secundario

Si newChild ya existe en el árbol del documento, se eliminará del árbol del documento y luego se volverá a insertar en su nueva posición. Los nodos de un documento (o los nodos creados por un documento) no se pueden insertar en otro documento. En otras palabras, la propiedad ownerDocument de newChild debe ser la misma que la propiedad ownerDocument del nodo actual.

replaceChild

Reemplazar un nodo hijo por otro

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

Parámetros de llamada:

• newChild : XmlNode , especifique un nuevo nodo
• oldChild : XmlNode , especifique el nodo a reemplazar

Devolver resultado:

• XmlNode , si 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 del documento, se eliminará del árbol del documento y luego se volverá a insertar en su nueva posición. Los nodos de un documento (o los nodos creados por un documento) no se pueden insertar en otro documento. En otras palabras, la propiedad ownerDocument de newChild debe ser la misma que la propiedad ownerDocument del nodo actual.

removeChild

Eliminar un nodo de la lista de nodos secundarios

1
XmlNode XmlElement.removeChild(XmlNode oldChild);

Parámetros de llamada:

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

Devolver resultado:

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

toString

Devuelve la representación en cadena del objeto, generalmente devuelve "[Native Object]", el objeto se puede volver a implementar de acuerdo con sus propias características

1
String XmlElement.toString();

Devolver resultado:

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

toJSON

Devuelve la representación en formato JSON del objeto, generalmente devuelve una colección de atributos legibles definidos por el objeto

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

Parámetros de llamada:

• key : Cadena, no utilizada

Devolver resultado:

• Value , devuelve un valor que contiene JSON serializable