OggettoXmlText
Un oggetto XmlText rappresenta il contenuto testuale di un elemento o attributo
Il nodo XmlText rappresenta una sequenza di testo semplice in un documento XML. Poiché negli elementi e negli attributi XML viene visualizzato testo semplice, il nodo XmlText in genere lo èXmlElementsomma dei nodiXmlAttrAppaiono i figli del nodo.
I nodi XmlText ereditanoXmlCharacterDatainterfaccia, tramiteXmlCharacterDataattributo data ereditato dall'interfaccia o daXmlNodeL'attributo nadevalue ereditato dall'interfaccia può accedere al contenuto testuale del nodo XmlText.
utilizzare daXmlCharacterDataI metodi ereditati o il metodo splitText() definito dall'interfaccia XmlText stessa possono gestire i nodi XmlText. utilizzoXmlDocumentcreateTextNode per creare un nuovo nodo XmlText.
Il nodo XmlText non ha nodi figlio.
Per i metodi di eliminazione dei nodi XmlText vuoti e di unione dei nodi XmlText adiacenti da un sottoalbero di un documento, vedereXmlNode.normalizemetodo.
rapporto ereditario
proprietà dei membri
data
String, il testo contenuto in questo nodo
1String XmlText.data;
length
Intero, il numero di caratteri contenuti in questo nodo
1readonly Integer XmlText.length;
nodeType
Intero, restituisce il tipo di nodo del nodo
1readonly Integer XmlText.nodeType;
Il nodeType di oggetti diversi restituirà valori diversi:
- XmlElement: ELEMENT_NODO(1)
- XmlAttr:ATTRIBUTE_NODO(2)
- XmlText: TESTO_NODO(3)
- XmlCDATASection: CDATA_SECTION_NODE(4)
- XmlProcessingInstruction: PROCESSING_INSTRUCTION_NODE(7)
- XmlComment:COMMENT_NODE(8)
- XmlDocument: DOCUMENT_NODE(9)
- XmlDocumentType: TIPO_DOCUMENTO_NODO(10)
nodeName
String, restituisce il nome del nodo, in base al suo tipo
1readonly String XmlText.nodeName;
Il nodeName di oggetti diversi restituirà valori diversi:
- XmlElement:nome dell'elemento
- XmlAttr: nome attributo
- XmlText: #testo
- XmlCDATASection: #cdata-sezione
- XmlProcessingInstruction: Restituisce la destinazione di destinazione specificata
- XmlComment: #commento
- XmlDocument: #documento
- XmlDocumentType: nome del tipo di documento
nodeValue
String, restituisce il nome del nodo, in base al suo tipo
1String XmlText.nodeValue;
Il nodeName di oggetti diversi restituirà valori diversi:
- XmlElement: nullo
- XmlAttr: valore dell'attributo
- XmlText: il contenuto del nodo
- XmlCDATASection: il contenuto del nodo
- XmlProcessingInstruction: Restituisce i dati del contenuto specificato
- XmlComment: testo dell'annotazione
- XmlDocument: nullo
- XmlDocumentType: nullo
ownerDocument
XmlDocument, restituisce l'elemento radice del nodo (XmlDocumentoggetto)
1readonly XmlDocument XmlText.ownerDocument;
parentNode
XmlNode, può restituire il nodo genitore di un nodo
1readonly XmlNode XmlText.parentNode;
childNodes
XmlNodeList, restituisce l'elenco dei nodi figlio del nodo specificato
1readonly XmlNodeList XmlText.childNodes;
children
XmlNodeList, restituisce l'elenco dei nodi dell'elemento figlio del nodo specificato.
1readonly XmlNodeList XmlText.children;
firstChild
XmlNode, restituisce il primo nodo figlio del nodo
1readonly XmlNode XmlText.firstChild;
lastChild
XmlNode, restituisce l'ultimo nodo figlio del nodo
1readonly XmlNode XmlText.lastChild;
previousSibling
XmlNode, restituisce il nodo immediatamente precedente a un nodo (allo stesso livello dell'albero). Se non esiste un nodo di questo tipo, questa proprietà restituisce null.
1readonly XmlNode XmlText.previousSibling;
nextSibling
XmlNode, restituisce il nodo immediatamente successivo a un elemento (nello stesso livello dell'albero). Se non esiste tale nodo, l'attributo restituisce null.
1readonly XmlNode XmlText.nextSibling;
firstElementChild
XmlNode, restituisce il primo nodo dell'elemento figlio del nodo
1readonly XmlNode XmlText.firstElementChild;
lastElementChild
XmlNode, restituisce l'ultimo nodo dell'elemento figlio del nodo
1readonly XmlNode XmlText.lastElementChild;
previousElementSibling
XmlNode, restituisce l'elemento nodo immediatamente precedente a un nodo (allo stesso livello dell'albero). Se non esiste tale nodo, questa proprietà restituisce null.
1readonly XmlNode XmlText.previousElementSibling;
nextElementSibling
XmlNode, restituisce il nodo dell'elemento immediatamente successivo a un elemento (nello stesso livello dell'albero). Se non esiste tale nodo, l'attributo restituisce null.
1readonly XmlNode XmlText.nextElementSibling;
textContent
Stringa, interroga e imposta il testo dell'elemento selezionato. Durante l'interrogazione, restituisce i valori di tutti i nodi di testo all'interno del nodo dell'elemento; durante l'impostazione, elimina tutti i nodi figli e li sostituisce con un singolo nodo di testo.
1String XmlText.textContent;
funzione membro
splitText
Dividere il nodo di testo in due nodi in base all'offset specificato
1XmlText XmlText.splitText(Integer offset);
Parametri di chiamata:
- offset: intero, specifica dove dividere i nodi di testo. Il valore iniziale inizia con 0
Risultati restituiti:
- XmlText, 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 di testo prima (ma escluso) il contenuto di testo nella posizione specificata da offset. Verrà creato un nuovo nodo XmlText per archiviare tutti i caratteri dalla posizione di offset (inclusi i caratteri in questa posizione) fino alla fine del carattere originale. Il nuovo nodo XmlText è il valore restituito di questo 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.
XmlCDATASectionL'interfaccia eredita l'interfaccia XmlText,XmlCDATASectionAnche i nodi possono utilizzare questo metodo, ma i nodi appena creati lo sonoXmlCDATASectionnodo invece di un nodo XmlText.
substringData
Estrai la sottostringa dal nodo
1
2String XmlText.substringData(Integer offset,
Integer count);
Parametri di chiamata:
- offset: Intero, la posizione del primo carattere da restituire
- count: Intero, il numero di caratteri nella sottostringa da restituire
Risultati restituiti:
- String, restituisce la stringa estratta
appendData
Aggiungi la stringa al nodo
1XmlText.appendData(String arg);
Parametri di chiamata:
- arg: String, la stringa da aggiungere al nodo
insertData
Inserisci la stringa nel nodo
1
2XmlText.insertData(Integer offset,
String arg);
Parametri di chiamata:
- offset: Intero, la posizione del carattere in cui la stringa deve essere inserita nel nodo
- arg: String, la stringa da inserire
deleteData
Rimuovi il testo dal nodo
1
2XmlText.deleteData(Integer offset,
Integer count);
Parametri di chiamata:
- offset: Numero intero, la posizione del primo carattere da eliminare
- count: Numero intero, il numero di caratteri da eliminare
replaceData
Sostituisci i caratteri del nodo con la stringa specificata
1
2
3XmlText.replaceData(Integer offset,
Integer count,
String arg);
Parametri di chiamata:
- offset: Intero, la posizione del carattere del nodo da sostituire
- count: Intero, il numero di caratteri da sostituire
- arg: String, la stringa da inserire
hasChildNodes
Interroga se sono presenti nodi figlio
1Boolean XmlText.hasChildNodes();
Risultati restituiti:
- Boolean, restituisce vero se sono presenti nodi figli, altrimenti restituisce falso
normalize
Unisci nodi di testo adiacenti ed elimina i nodi di testo vuoti
1XmlText.normalize();
Questo metodo attraverserà tutti i nodi discendenti del nodo corrente e normalizzerà il documento eliminando i nodi di testo vuoti e unendo tutti i nodi di testo adiacenti. Questo metodo è utile per semplificare la struttura dell'albero del documento dopo aver inserito o eliminato nodi.
cloneNode
Crea una copia esatta del nodo specificato
1XmlNode XmlText.cloneNode(Boolean deep = true);
Parametri di chiamata:
- deep: Booleano, se eseguire la copia profonda, quando è vero, il nodo clonato clonerà tutti i nodi figlio del nodo originale
Risultati restituiti:
- XmlNode, restituisce il nodo copiato
Questo metodo copierà e restituirà una copia del nodo su cui è stato chiamato. Se l'argomento passato è vero, copierà ricorsivamente anche tutti i nodi discendenti del nodo corrente. Altrimenti, copia solo il nodo corrente. Il nodo restituito non appartiene all'albero del documento e la sua proprietà parentNode è nulla. Quando un nodo Elemento viene copiato, verranno copiate tutte le sue proprietà.
lookupPrefix
Restituisce il prefisso corrispondente all'URI dello spazio dei nomi specificato sul nodo corrente
1String XmlText.lookupPrefix(String namespaceURI);
Parametri di chiamata:
- namespaceURI: String, specifica l'URI dello spazio dei nomi corrispondente
Risultati restituiti:
- String, restituisce il prefisso corrispondente, restituisce null se non corrisponde.
lookupNamespaceURI
Restituisce l'URI dello spazio dei nomi corrispondente al prefisso specificato sul nodo corrente
1String XmlText.lookupNamespaceURI(String prefix);
Parametri di chiamata:
- prefix: String, specifica il prefisso corrispondente
Risultati restituiti:
- String, restituisce l'URI dello spazio dei nomi corrispondente, restituisce null se non corrisponde.
insertBefore
Inserisci un nuovo nodo figlio prima di un nodo figlio esistente
1
2XmlNode 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
Risultati restituiti:
- XmlNode, restituisce il nuovo nodo figlio
Se newChild esiste già nell'albero del documento, verrà rimosso dall'albero del documento e 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. Cioè, l'attributoownerDocument di newChild deve essere uguale all'attributoownerDocument del nodo corrente.
insertAfter
Inserisci un nuovo nodo figlio dopo un nodo figlio esistente
1
2XmlNode XmlText.insertAfter(XmlNode newChild,
XmlNode refChild);
Parametri di chiamata:
- newChild:XmlNode, inserisci un nuovo nodo
- refChild:XmlNode, inserisci un nuovo nodo dopo questo nodo
Risultati restituiti:
- XmlNode, restituisce il nuovo nodo figlio
Se newChild esiste già nell'albero del documento, verrà rimosso dall'albero del documento e 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. Cioè, l'attributoownerDocument di newChild deve essere uguale all'attributoownerDocument del nodo corrente.
appendChild
Aggiunge un nuovo nodo figlio alla fine dell'elenco dei nodi figlio di un nodo
1XmlNode XmlText.appendChild(XmlNode newChild);
Parametri di chiamata:
- newChild:XmlNode, specificare il nodo aggiunto
Risultati restituiti:
- XmlNode, restituisce questo nuovo nodo figlio
Se newChild esiste già nell'albero del documento, verrà rimosso dall'albero del documento e 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. Cioè, l'attributoownerDocument di newChild deve essere uguale all'attributoownerDocument del nodo corrente.
replaceChild
Sostituisci un nodo figlio con un altro
1
2XmlNode XmlText.replaceChild(XmlNode newChild,
XmlNode oldChild);
Parametri di chiamata:
Risultati restituiti:
- XmlNode, Se la sostituzione ha esito positivo, questo metodo può restituire il nodo sostituito. Se la sostituzione fallisce, restituisce null.
Se newChild esiste già nell'albero del documento, verrà rimosso dall'albero del documento e 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. Cioè, l'attributoownerDocument di newChild deve essere uguale all'attributoownerDocument del nodo corrente.
removeChild
Rimuovere un nodo dall'elenco dei nodi figlio
1XmlNode XmlText.removeChild(XmlNode oldChild);
Parametri di chiamata:
- oldChild:XmlNode, specifica il nodo da eliminare
Risultati restituiti:
- XmlNode, Se l'eliminazione ha esito positivo, questo metodo può restituire il nodo eliminato. Se fallisce, restituisce null.
toString
Restituisce la rappresentazione in formato stringa dell'oggetto. Generalmente viene restituito "[Oggetto nativo]". L'oggetto può essere reimplementato in base alle proprie caratteristiche.
1String XmlText.toString();
Risultati restituiti:
- String, restituisce la rappresentazione di stringa dell'oggetto
toJSON
Restituisce una rappresentazione in formato JSON dell'oggetto, generalmente restituendo una raccolta di proprietà leggibili definite dall'oggetto.
1Value XmlText.toJSON(String key = "");
Parametri di chiamata:
- key: Stringa, non utilizzata
Risultati restituiti:
- Value, restituisce un valore contenente JSON serializzabile