Oggetto XmlText

L'oggetto XmlText rappresenta il contenuto di testo di un elemento o attributo

Il nodo XmlText rappresenta una serie di testo normale in un documento XML. Poiché il testo normale viene visualizzato negli elementi e negli attributi di XML, i nodi XmlText in genere vengono visualizzati come nodi figlio dei nodi XmlElement e XmlAttr .

Il nodo XmlText eredita l'interfaccia XmlCharacterData È possibile accedere al contenuto di testo del nodo XmlText tramite l'attributo dati ereditato dall'interfaccia XmlCharacterData o l'attributo nadevalue ereditato dall'interfaccia XmlNode .

Il nodo XmlText può essere manipolato dal metodo ereditato da XmlCharacterData o dal metodo splitText () definito dall'interfaccia XmlText stessa. Utilizzare createTextNode di XmlDocument per creare un nuovo nodo XmlText.

Il nodo XmlText non ha figli.

Per il metodo di eliminazione di nodi XmlText vuoti e di unione di nodi XmlText adiacenti dalla sottostruttura del documento, fare riferimento al metodo XmlNode.normalize .

Eredità

Attributi dei membri

data

String, il testo contenuto nel nodo

1
String XmlText.data;

length

Integer, il numero di caratteri contenuti nel nodo

1
readonly Integer XmlText.length;

nodeType

Intero, restituisce il tipo di nodo del nodo

1
readonly Integer XmlText.nodeType;

Il nodeType di oggetti diversi restituirà valori diversi:

• 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

Stringa, restituisce il nome del nodo, in base al suo tipo

1
readonly String XmlText.nodeName;

Il nodeName di oggetti diversi restituirà valori diversi:

• XmlElement : nome dell'elemento
• XmlAttr : nome dell'attributo
• XmlText : #text
• XmlCDATASection : # cdata-section
• XmlProcessingInstruction : restituisce la destinazione di destinazione specificata
• XmlComment : #comment
• XmlDocument : #document
• XmlDocumentType : nome doctype

nodeValue

Stringa, restituisce il nome del nodo, in base al suo tipo

1
String XmlText.nodeValue;

Il nodeName di oggetti diversi restituirà valori diversi:

• XmlElement : null
• XmlAttr : il valore dell'attributo
• XmlText : il contenuto del nodo
• XmlCDATASection : il contenuto del nodo
• XmlProcessingInstruction : restituisce i dati del contenuto specificato
• XmlComment : testo del commento
• XmlDocument : null
• XmlDocumentType : null

ownerDocument

XmlDocument , restituisce l'elemento radice del nodo (oggetto XmlDocument )

1
readonly XmlDocument XmlText.ownerDocument;

parentNode

XmlNode , può restituire il nodo padre di un nodo

1
readonly XmlNode XmlText.parentNode;

childNodes

XmlNodeList , restituisce l'elenco dei nodi dei nodi figlio del nodo specificato

1
readonly XmlNodeList XmlText.childNodes;

firstChild

XmlNode , restituisce il primo nodo figlio del nodo

1
readonly XmlNode XmlText.firstChild;

lastChild

XmlNode , restituisce l'ultimo nodo figlio del nodo

1
readonly XmlNode XmlText.lastChild;

previousSibling

XmlNode , restituisce il nodo immediatamente prima di un nodo (allo stesso livello dell'albero), se non esiste tale nodo, questa proprietà restituisce null

1
readonly XmlNode XmlText.previousSibling;

nextSibling

XmlNode , restituisce il nodo immediatamente successivo a un elemento (nello stesso livello dell'albero), se non esiste tale nodo, la proprietà restituisce null

1
readonly XmlNode XmlText.nextSibling;

Funzione membro

splitText

Dividi il nodo di testo in due nodi in base all'offset specificato

1
XmlText XmlText.splitText(Integer offset);

Parametri di chiamata:

• offset : numero intero, che specifica dove dividere il nodo di testo. Il valore iniziale inizia da 0

Risultato di ritorno:

• XmlText , il nodo di testo diviso dal nodo corrente

Questo metodo dividerà il nodo XmlText in due nodi all'offset specificato. Il nodo XmlText originale verrà modificato in modo che contenga il contenuto del testo (ma non includendo il contenuto del testo) prima della posizione specificata da offset. Verrà creato un nuovo nodo XmlText per memorizzare tutti i caratteri dalla posizione di offset (incluso il carattere in quella posizione) alla fine del carattere originale. Il nuovo nodo XmlText è il valore restituito dal metodo. Inoltre, se il nodo XmlText originale ha un parentNode, il nuovo nodo XmlText verrà inserito in questo nodo padre immediatamente dopo il nodo originale.

XmlCDATASection interfaccia XmlCDATASection eredita l'interfaccia XmlText e anche il nodo XmlCDATASection può utilizzare questo metodo, ma il nodo appena creato è un nodo XmlCDATASection , non un nodo XmlText.

substringData

Estrai sottostringa dal nodo

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

Parametri di chiamata:

• offset : Integer, la posizione del primo carattere da restituire
• count : Integer, il numero di caratteri nella sottostringa da restituire

Risultato di ritorno:

• String , restituisce la stringa estratta

appendData

Aggiungi la stringa al nodo

1
XmlText.appendData(String arg);

Parametri di chiamata:

• arg : String, stringa da aggiungere al nodo

insertData

Inserisci la stringa nel nodo

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

Parametri di chiamata:

• offset : numero intero, la posizione del carattere in cui la stringa deve essere inserita nel nodo
• arg : String, la stringa da inserire

deleteData

Elimina il testo dal nodo

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

Parametri di chiamata:

• offset : numero intero, la posizione del primo carattere da eliminare
• count : Integer, il numero di caratteri da eliminare

replaceData

Sostituisci i caratteri del nodo con la stringa specificata

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

Parametri di chiamata:

• offset : Integer, la posizione del carattere del nodo da sostituire
• count : Integer, il numero di caratteri da sostituire
• arg : String, la stringa da inserire

hasChildNodes

Interroga se sono presenti nodi figlio

1
Boolean XmlText.hasChildNodes();

Risultato di ritorno:

• Boolean , restituisce true se sono presenti nodi figlio, altrimenti restituisce false

normalize

Unisci i nodi di testo adiacenti ed elimina i nodi di testo vuoti

1
XmlText.normalize();

Questo metodo attraverserà tutti i nodi discendenti del nodo corrente e normalizzerà il documento eliminando il nodo di testo vuoto e unendo tutti i nodi di testo adiacenti. Questo metodo è utile per semplificare la struttura dell'albero del documento dopo aver inserito o eliminato i nodi.

cloneNode

Crea una copia esatta del nodo specificato

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

Parametri di chiamata:

• deep : Boolean, se eseguire la copia profonda, quando true, il nodo clonato clonerà tutti i nodi figlio del nodo originale

Risultato di ritorno:

• XmlNode , restituisce il nodo copiato

Questo metodo copierà e restituirà una copia del nodo che lo ha chiamato. Se il parametro passato ad esso è vero, copierà anche ricorsivamente tutti i discendenti del nodo corrente. In caso contrario, copia solo il nodo corrente. Il nodo restituito non appartiene alla struttura ad albero del documento e la sua proprietà parentNode è null. Quando il nodo Elemento viene copiato, verranno copiati tutti i suoi attributi.

lookupPrefix

Restituisce il prefisso corrispondente all'URI dello spazio dei nomi specificato sul nodo corrente

1
String XmlText.lookupPrefix(String namespaceURI);

Parametri di chiamata:

• namespaceURI : stringa, specifica l'URI dello spazio dei nomi corrispondente

Risultato di ritorno:

• String , restituisce il prefisso corrispondente, restituisce null se non corrisponde

lookupNamespaceURI

Restituisce l'URI dello spazio dei nomi che corrisponde al prefisso specificato sul nodo corrente

1
String XmlText.lookupNamespaceURI(String prefix);

Parametri di chiamata:

• prefix : String, specifica il prefisso corrispondente

Risultato di ritorno:

• String , restituisce l'URI dello spazio dei nomi corrispondente, restituisce null se non corrisponde

insertBefore

Inserisci un nuovo nodo figlio prima del nodo figlio esistente

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

Parametri di chiamata:

• newChild : XmlNode , inserisci un nuovo nodo
• refChild : XmlNode , inserisci un nuovo nodo prima di questo nodo

Risultato di ritorno:

• XmlNode , restituisce il nuovo nodo figlio

Se newChild esiste già nell'albero del documento, verrà eliminato dall'albero del documento e quindi reinserito nella sua nuova posizione. I nodi di un documento (o i nodi creati da un documento) non possono essere inseriti in un altro documento. In altre parole, la proprietà ownerDocument di newChild deve essere uguale alla proprietà ownerDocument del nodo corrente.

insertAfter

Inserisci un nuovo nodo figlio dopo il nodo figlio esistente

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

Parametri di chiamata:

• newChild : XmlNode , inserisci un nuovo nodo
• refChild : XmlNode , inserisci un nuovo nodo dopo questo nodo

Risultato di ritorno:

• XmlNode , restituisce il nuovo nodo figlio

Se newChild esiste già nell'albero del documento, verrà eliminato dall'albero del documento e quindi reinserito nella sua nuova posizione. I nodi di un documento (o i nodi creati da un documento) non possono essere inseriti in un altro documento. In altre parole, la proprietà ownerDocument di newChild deve essere uguale alla proprietà ownerDocument del nodo corrente.

appendChild

Aggiungi un nuovo nodo figlio alla fine dell'elenco dei nodi figlio del nodo

1
XmlNode XmlText.appendChild(XmlNode newChild);

Parametri di chiamata:

• newChild : XmlNode , specifica il nodo aggiunto

Risultato di ritorno:

• XmlNode , restituisce questo nuovo nodo figlio

Se newChild esiste già nell'albero del documento, verrà eliminato dall'albero del documento e quindi reinserito nella sua nuova posizione. I nodi di un documento (o i nodi creati da un documento) non possono essere inseriti in un altro documento. In altre parole, la proprietà ownerDocument di newChild deve essere uguale alla proprietà ownerDocument del nodo corrente.

replaceChild

Sostituisci un nodo figlio con un altro

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

Parametri di chiamata:

• newChild : XmlNode , specifica un nuovo nodo
• oldChild : XmlNode , specifica il nodo da sostituire

Risultato di ritorno:

• XmlNode , se la sostituzione ha esito positivo, questo metodo può restituire il nodo sostituito, se la sostituzione non riesce, restituisce null

Se newChild esiste già nell'albero del documento, verrà eliminato dall'albero del documento e quindi reinserito nella sua nuova posizione. I nodi di un documento (o i nodi creati da un documento) non possono essere inseriti in un altro documento. In altre parole, la proprietà ownerDocument di newChild deve essere uguale alla proprietà ownerDocument del nodo corrente.

removeChild

Rimuovi un nodo dall'elenco dei nodi figlio

1
XmlNode XmlText.removeChild(XmlNode oldChild);

Parametri di chiamata:

• oldChild : XmlNode , specifica il nodo da eliminare

Risultato di ritorno:

• XmlNode , se l'eliminazione ha esito positivo, questo metodo può restituire il nodo eliminato, se non riesce, restituisce null

toString

Restituisce la rappresentazione in stringa dell'oggetto, generalmente restituisce "[Native Object]", l'oggetto può essere reimplementato secondo le proprie caratteristiche

1
String XmlText.toString();

Risultato di ritorno:

• String , restituisce la rappresentazione di stringa dell'oggetto

toJSON

Restituisce la rappresentazione in formato JSON dell'oggetto, generalmente restituisce una raccolta di attributi leggibili definiti dall'oggetto

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

Parametri di chiamata:

• key : stringa, non utilizzata

Risultato di ritorno:

• Value , restituisce un valore contenente JSON serializzabile