ObjectXmlText

Un obxecto XmlText representa o contido de texto dun elemento ou atributo

O nodo XmlText representa unha secuencia de texto plano nun documento XML. Como o texto simple aparece nos elementos e atributos XML, o nodo XmlText adoita serXmlElementsuma de nodosXmlAttrAparecen os fillos do nodo.

Os nodos XmlText herdanXmlCharacterDatainterface, víaXmlCharacterDataatributo de datos herdado da interface ou deXmlNodeO atributo nadevalue herdado pola interface pode acceder ao contido de texto do nodo XmlText.

usar desdeXmlCharacterDataOs métodos herdados ou o método splitText() definido pola propia interface XmlText poden operar nodos XmlText. usarXmlDocumentcreateTextNode para crear un novo nodo XmlText.

O nodo XmlText non ten nodos fillos.

Para obter métodos de eliminación de nós de XmlText baleiros e de fusión de nós de XmlText adxacentes dunha subárbore dun documento, consulteXmlNode.normalizemétodo.

relación de herdanza

propiedades dos membros

data

String, o texto contido neste nodo

1
String XmlText.data;

length

Enteiro, o número de caracteres contidos neste nodo

1readonly Integer XmlText.length;

nodeType

Enteiro, devolve o tipo de nodo do nodo

1readonly Integer XmlText.nodeType;

O nodeType de diferentes obxectos devolverá valores diferentes:

XmlElement: ELEMENT_NODE(1)
XmlAttr:ATTRIBUTE_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, devolve o nome do nodo, segundo o seu tipo

1
readonly String XmlText.nodeName;

O nodeName de diferentes obxectos devolverá valores diferentes:

XmlElement: nome do elemento
XmlAttr: nome do atributo
XmlText: #texto
XmlCDATASection: #cdata-section
XmlProcessingInstruction: Devolve o destino de destino especificado
XmlComment: #comentar
XmlDocument: #documento
XmlDocumentType: nome do tipo de documento

nodeValue

String, devolve o nome do nodo, segundo o seu tipo

1
String XmlText.nodeValue;

O nodeName de diferentes obxectos devolverá valores diferentes:

XmlElement: nulo
XmlAttr: valor do atributo
XmlText: o contido do nodo
XmlCDATASection: o contido do nodo
XmlProcessingInstruction: Devolve os datos de contido especificados
XmlComment: texto de anotación
XmlDocument: nulo
XmlDocumentType: nulo

ownerDocument

XmlDocument, devolve o elemento raíz do nodo (XmlDocumentobxecto)

1readonly XmlDocument XmlText.ownerDocument;

parentNode

XmlNode, pode devolver o nodo pai dun nodo

1readonly XmlNode XmlText.parentNode;

childNodes

XmlNodeList, devolve a lista de nodos dos nodos fillos do nodo especificado

1readonly XmlNodeList XmlText.childNodes;

children

XmlNodeList, devolve a lista de nodos dos nodos do elemento fillo do nodo especificado.

1readonly XmlNodeList XmlText.children;

firstChild

XmlNode, devolve o primeiro nodo fillo do nodo

1readonly XmlNode XmlText.firstChild;

lastChild

XmlNode, devolve o último nodo fillo do nodo

1readonly XmlNode XmlText.lastChild;

previousSibling

XmlNode, devolve o nodo inmediatamente anterior a un nodo (no mesmo nivel de árbore). Se non hai tal nodo, esta propiedade devolve nulo.

1readonly XmlNode XmlText.previousSibling;

nextSibling

XmlNode, devolve o nodo inmediatamente despois dun elemento (no mesmo nivel de árbore). Se non hai tal nodo, o atributo devolve nulo.

1readonly XmlNode XmlText.nextSibling;

firstElementChild

XmlNode, devolve o primeiro nodo do elemento fillo do nodo

1readonly XmlNode XmlText.firstElementChild;

lastElementChild

XmlNode, devolve o último nodo do elemento fillo do nodo

1readonly XmlNode XmlText.lastElementChild;

previousElementSibling

XmlNode, devolve o nodo do elemento inmediatamente anterior a un nodo (no mesmo nivel de árbore). Se non hai tal nodo, esta propiedade devolve nulo.

1readonly XmlNode XmlText.previousElementSibling;

nextElementSibling

XmlNode, devolve o nodo do elemento inmediatamente despois dun elemento (no mesmo nivel de árbore). Se non hai tal nodo, o atributo devolve nulo.

1readonly XmlNode XmlText.nextElementSibling;

textContent

Cadena, consulta e establece o texto do elemento seleccionado. Ao consultar, devolve os valores de todos os nodos de texto dentro do nodo de elemento; ao configurar, elimina todos os nodos fillos e substitúeos por un único nodo de texto.

1
String XmlText.textContent;

función de membro

splitText

Divide o nodo de texto en dous nodos segundo a compensación especificada

1XmlText XmlText.splitText(Integer offset);

Parámetros de chamada:

offset: Número enteiro, especifica onde dividir os nós de texto. O valor inicial comeza con 0

Resultados de devolución:

XmlText, O nodo de texto dividido do nodo actual

Este método dividirá o nodo XmlText en dous nodos co desplazamento especificado. O nodo XmlText orixinal modificarase para que conteña o contido do texto antes (pero sen incluír) o contido do texto na posición especificada por compensación. Crearase un novo nodo XmlText para almacenar todos os caracteres desde a posición de desprazamento (incluídos os caracteres nesta posición) ata o final do carácter orixinal. O novo nodo XmlText é o valor de retorno deste método. Ademais, se o nodo XmlText orixinal ten un nodo pai, o novo nodo XmlText inserirase neste nodo pai, inmediatamente despois do nodo orixinal.

XmlCDATASectionA interface herda a interface XmlText,XmlCDATASectionOs nós tamén poden usar este método, pero os nodos recén creados siXmlCDATASectionnodo en lugar dun nodo XmlText.

substringData

Extrae subcadea do nodo

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

Parámetros de chamada:

offset: Enteiro, a posición do primeiro carácter que se devolverá
count: Enteiro, o número de caracteres da subcadea que se devolverá

Resultados de devolución:

String, devolve a cadea extraída

appendData

Engadir cadea ao nodo

1
XmlText.appendData(String arg);

Parámetros de chamada:

arg: String, a cadea que se vai engadir ao nodo

insertData

Inserir cadea no nodo

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

Parámetros de chamada:

offset: Enteiro, a posición do carácter na que se debe inserir a cadea no nodo
arg: String, a cadea que se vai inserir

deleteData

Eliminar texto do nodo

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

Parámetros de chamada:

offset: Enteiro, a posición do primeiro carácter que se vai eliminar
count: Número enteiro, o número de caracteres a eliminar

replaceData

Substitúe os caracteres do nodo pola cadea especificada

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

Parámetros de chamada:

offset: Enteiro, a posición do carácter do nodo que se vai substituír
count: Enteiro, o número de caracteres a substituír
arg: String, a cadea que se vai inserir

hasChildNodes

Consulta se hai nós fillos

1
Boolean XmlText.hasChildNodes();

Resultados de devolución:

Boolean, devolve verdadeiro se hai algún nodo fillo, se non, devolve falso

normalize

Combina os nós de Texto adxacentes e elimina os nós de Texto baleiros

1XmlText.normalize();

Este método atravesará todos os nodos descendentes do nodo actual e normalizará o documento eliminando os nós de Texto baleiros e fusionando todos os nós de Texto adxacentes. Este método é útil para simplificar a estrutura da árbore do documento despois de inserir ou eliminar nós.

cloneNode

Crea unha copia exacta do nodo especificado

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

Parámetros de chamada:

deep: Booleano, se debe copiar en profundidade, cando é verdadeiro, o nodo clonado clonará todos os nodos fillos do nodo orixinal

Resultados de devolución:

XmlNode, devolve o nodo copiado

Este método copiará e devolverá unha copia do nodo no que foi chamado. Se o argumento que se lle pasou é verdadeiro, tamén copiará de forma recursiva todos os nodos descendentes do nodo actual. En caso contrario, só copia o nodo actual. O nodo devolto non pertence á árbore do documento e a súa propiedade parentNode é nula. Cando se copia un nodo Element, copiaranse todas as súas propiedades.

lookupPrefix

Devolve o prefixo que coincide co URI de espazo de nomes especificado no nodo actual

1
String XmlText.lookupPrefix(String namespaceURI);

Parámetros de chamada:

namespaceURI: Cadea, especifica o URI do espazo de nomes coincidente

Resultados de devolución:

String, devolve o prefixo coincidente, devolve nulo se non coincide.

lookupNamespaceURI

Devolve o URI do espazo de nomes que coincide co prefixo especificado no nodo actual

1
String XmlText.lookupNamespaceURI(String prefix);

Parámetros de chamada:

prefix: Cadea, especifica o prefixo coincidente

Resultados de devolución:

String, devolve o URI do espazo de nomes coincidente, devolve nulo se non coincide.

insertBefore

Insira un novo nodo fillo antes dun nodo fillo existente

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

Parámetros de chamada:

newChild:XmlNode, inserir un novo nodo
refChild:XmlNode, inserir un novo nodo antes deste nodo

Resultados de devolución:

XmlNode, devolve o novo nodo fillo

Se xa existe newChild na árbore de documentos, eliminarase da árbore de documentos e reinserirase na súa nova posición. Os nós dun documento (ou os nodos creados por un documento) non se poden inserir noutro documento. É dicir, o atributo ownerDocument de newChild debe ser o mesmo que o atributo ownerDocument do nodo actual.

insertAfter

Insira un novo nodo fillo despois dun nodo fillo existente

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

Parámetros de chamada:

newChild:XmlNode, inserir un novo nodo
refChild:XmlNode, insira un novo nodo despois deste nodo

Resultados de devolución:

XmlNode, devolve o novo nodo fillo

appendChild

Engade un novo nodo fillo ao final da lista de nodos fillos dun nodo

1XmlNode XmlText.appendChild(XmlNode newChild);

Parámetros de chamada:

newChild:XmlNode, especifique o nodo engadido

Resultados de devolución:

XmlNode, devolve este novo nodo fillo

replaceChild

Substitúe un nodo fillo por outro

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

Parámetros de chamada:

newChild:XmlNode, especifique o novo nodo
oldChild:XmlNode, especifica o nodo que se vai substituír

Resultados de devolución:

XmlNode, Se a substitución ten éxito, este método pode devolver o nodo substituído. Se a substitución falla, devolve nulo.

removeChild

Elimina un nodo da lista de nodos fillos

1XmlNode XmlText.removeChild(XmlNode oldChild);

Parámetros de chamada:

oldChild:XmlNode, especifica o nodo que se vai eliminar

Resultados de devolución:

XmlNode, Se a eliminación é correcta, este método pode devolver o nodo eliminado. Se falla, devolve nulo.

toString

Devolve a representación en cadea do obxecto. Polo xeral, devólvese "[Obxecto nativo]". O obxecto pódese volver implementar segundo as súas propias características.

1
String XmlText.toString();

Resultados de devolución:

String, devolve a representación en cadea do obxecto

toJSON

Devolve unha representación en formato JSON do obxecto, devolvendo xeralmente unha colección de propiedades lexibles definidas polo obxecto.

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

Parámetros de chamada:

key: Cadena, non usada

Resultados de devolución:

Value, devolve un valor que contén JSON serializable

Guía de desenvolvemento

Módulo básico

obxectos incorporados

módulo comunitario

ObjectXmlText

relación de herdanza

propiedades dos membros

data

length

nodeType

nodeName

nodeValue

ownerDocument

parentNode

childNodes

children

firstChild

lastChild

previousSibling

nextSibling

firstElementChild

lastElementChild

previousElementSibling

nextElementSibling

textContent

función de membro

splitText

substringData

appendData

insertData

deleteData

replaceData

hasChildNodes

normalize

cloneNode

lookupPrefix

lookupNamespaceURI

insertBefore

insertAfter

appendChild

replaceChild

removeChild

toString

toJSON