Object XmlCDATASection

L'oggetto XmlCDATASection rappresenta la sezione CDATA nel documento

L'interfaccia XmlCDATASection è una sotto-interfaccia dell'interfaccia XmlText e non definisce nessuna delle sue proprietà e metodi. È possibile accedere al contenuto del testo della sezione CDATA ereditando la proprietà nodeValue dall'interfaccia XmlNode o ereditando la proprietà data dall'interfaccia XmlCharacterData .

Sebbene il nodo XmlCDATASection possa in genere essere trattato come un nodo XmlText , è necessario notare che il metodo di normalizzazione di XmlNode non è incorporato nella sezione CDATA adiacente.

Utilizzare il metodo createXmlCDATASection di XmlDocument per creare una XmlCDATASection.

La sezione CDATA contiene testo che non verrà analizzato dal parser. I tag nella sezione CDATA non verranno considerati tag e le entità non verranno espanse. Lo scopo principale è quello di includere materiali come frammenti XML senza dover sfuggire a tutti i separatori.

L'unico separatore riconosciuto in un CDATA è "]]>", che può segnare la fine della sezione CDATA. Le sezioni CDATA non possono essere nidificate.

Eredità

Attributo membro

data

String, il testo contenuto nel nodo

1
String XmlCDATASection.data;

length

Numero intero, il numero di caratteri in questo nodo

1
readonly Integer XmlCDATASection.length;

nodeType

Numero intero, restituisce il tipo di nodo del nodo

1
readonly Integer XmlCDATASection.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

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

1
readonly String XmlCDATASection.nodeName;

Il nome nodo di oggetti diversi restituirà valori diversi:

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

nodeValue

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

1
String XmlCDATASection.nodeValue;

Il nome nodo 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 di contenuto specificati
• XmlComment : testo del commento
• XmlDocument : null
• XmlDocumentType : null

ownerDocument

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

1
readonly XmlDocument XmlCDATASection.ownerDocument;

parentNode

XmlNode , può restituire il nodo padre di un nodo

1
readonly XmlNode XmlCDATASection.parentNode;

childNodes

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

1
readonly XmlNodeList XmlCDATASection.childNodes;

firstChild

XmlNode , restituisce il primo nodo figlio del nodo

1
readonly XmlNode XmlCDATASection.firstChild;

lastChild

XmlNode , restituisce l'ultimo nodo figlio del nodo

1
readonly XmlNode XmlCDATASection.lastChild;

previousSibling

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

1
readonly XmlNode XmlCDATASection.previousSibling;

nextSibling

XmlNode , restituisce il nodo immediatamente dopo un elemento (nello stesso livello dell'albero), se non esiste tale nodo, l'attributo restituisce null

1
readonly XmlNode XmlCDATASection.nextSibling;

Funzione membro

splitText

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

1
XmlText XmlCDATASection.splitText(Integer offset);

Parametri di chiamata:

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

Risultato di ritorno:

• XmlText , nodo di testo diviso dal nodo corrente

Questo metodo divide il nodo XmlText in due nodi con l'offset specificato. Il nodo XmlText originale verrà modificato in modo che contenga il contenuto del testo (ma non il contenuto del testo) prima della posizione specificata dall'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 da questo metodo. Inoltre, se il nodo XmlText originale ha un parentNode, il nuovo nodo XmlText verrà inserito in questo nodo parent, immediatamente dopo il nodo originale.

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

substringData

Estrarre sottostringhe dai nodi

1
2
String XmlCDATASection.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

Risultato di ritorno:

• String , restituisce la stringa estratta

appendData

Aggiungi stringa al nodo

1
XmlCDATASection.appendData(String arg);

Parametri di chiamata:

• arg : String, la stringa da aggiungere al nodo

insertData

Inserisci la stringa nel nodo

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

Parametri di chiamata:

• offset : intero, la posizione del carattere del nodo da inserire nella stringa
• arg : String, la stringa da inserire

deleteData

Elimina il testo dal nodo

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

Parametri di chiamata:

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

replaceData

Sostituisci il carattere del nodo con la stringa specificata

1
2
3
XmlCDATASection.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

Controlla se esiste un nodo figlio

1
Boolean XmlCDATASection.hasChildNodes();

Risultato di ritorno:

• Boolean , restituisce vero se ci sono nodi figlio, altrimenti restituisce falso

normalize

Unisci nodi di testo adiacenti ed elimina nodi di testo vuoti

1
XmlCDATASection.normalize();

Questo metodo attraverserà tutti i discendenti del nodo corrente, eliminando il nodo Testo vuoto, ha unito tutti i nodi di testo adiacenti per normalizzare il documento. 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 XmlCDATASection.cloneNode(Boolean deep = true);

Parametri di chiamata:

• deep : Booleano, se copiare in profondità, quando è vero, il nodo clonato clonerà tutti i nodi figlio del nodo originale

Risultato di ritorno:

• XmlNode , restituisce il nodo copiato

Questo metodo copia e restituisce una copia del nodo che lo ha chiamato. Se il parametro passato ad esso è vero, copierà anche in modo ricorsivo tutti i discendenti del nodo corrente. Altrimenti, copia solo il nodo corrente. Il nodo restituito non appartiene all'albero del documento e l'attributo parentNode è nullo. Quando si copia un nodo Elemento, verranno copiati tutti i suoi attributi.

lookupPrefix

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

1
String XmlCDATASection.lookupPrefix(String namespaceURI);

Parametri di chiamata:

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

Risultato di ritorno:

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

lookupNamespaceURI

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

1
String XmlCDATASection.lookupNamespaceURI(String prefix);

Parametri di chiamata:

• prefix : stringa, specificare il prefisso corrispondente

Risultato di ritorno:

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

insertBefore

Inserire un nuovo nodo figlio prima del nodo figlio esistente

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

Parametri di chiamata:

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

Risultato di ritorno:

• XmlNode , restituisce un nuovo nodo figlio

Se newChild esiste già nella struttura del documento, verrà eliminata dalla struttura del documento e quindi reinserita nella nuova posizione. I nodi di un documento (o 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

Inserire un nuovo nodo figlio dopo il nodo figlio esistente

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

Parametri di chiamata:

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

Risultato di ritorno:

• XmlNode , restituisce un nuovo nodo figlio

Se newChild esiste già nella struttura del documento, verrà eliminata dalla struttura del documento e quindi reinserita nella nuova posizione. I nodi di un documento (o 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 XmlCDATASection.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à nella struttura del documento, verrà eliminata dalla struttura del documento e quindi reinserita nella nuova posizione. I nodi di un documento (o 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 XmlCDATASection.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à nella struttura del documento, verrà eliminata dalla struttura del documento e quindi reinserita nella nuova posizione. I nodi di un documento (o 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

Rimuovere un nodo dall'elenco dei nodi figlio

1
XmlNode XmlCDATASection.removeChild(XmlNode oldChild);

Parametri di chiamata:

• oldChild : XmlNode , specifica il nodo da eliminare

Risultato di ritorno:

• XmlNode , se la cancellazione ha esito positivo, questo metodo può restituire il nodo eliminato, se fallisce, restituisce null

toString

Restituisce la rappresentazione in forma di stringa dell'oggetto, in genere restituisce "[Native Object]", l'oggetto può essere reimplementato in base alle proprie caratteristiche

1
String XmlCDATASection.toString();

Risultato di ritorno:

• String , restituisce una rappresentazione in formato stringa dell'oggetto

toJSON

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

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

Parametri di chiamata:

• key : stringa, non utilizzata

Risultato di ritorno:

• Value , restituisce un valore contenente serializzabile JSON