Oggetto XmlCDATASection

L'oggetto XmlCDATASection rappresenta la sezione CDATA nel documento

L'interfaccia XmlCDATASection è un'interfaccia secondaria dell'interfaccia XmlText e non definisce proprietà e metodi propri. XmlNode la proprietà nodeValue dall'interfaccia XmlNode o ereditando la proprietà data dall'interfaccia XmlCharacterData , è possibile accedere al contenuto di testo della sezione CDATA.

Sebbene il nodo XmlCDATASection possa in genere essere trattato come un nodo XmlText , è opportuno notare che il metodo normalize di XmlNode non incorpora la 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 come contrassegni e le entità non verranno espanse. Lo scopo principale è includere materiale come frammenti XML senza dover eseguire l'escape di tutti i separatori.

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

Eredità

Attributi dei membri

data

String, il testo contenuto nel nodo

1
String XmlCDATASection.data;

length

Integer, il numero di caratteri contenuti nel nodo

1
readonly Integer XmlCDATASection.length;

nodeType

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

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

1
readonly String XmlCDATASection.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 XmlCDATASection.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 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 dell'albero), se non esiste tale nodo, questa proprietà restituisce null

1
readonly XmlNode XmlCDATASection.previousSibling;

nextSibling

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

1
readonly XmlNode XmlCDATASection.nextSibling;

Funzione membro

splitText

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

1
XmlText XmlCDATASection.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 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 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.

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

substringData

Estrai sottostringa dal nodo

1
2
String XmlCDATASection.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
XmlCDATASection.appendData(String arg);

Parametri di chiamata:

• arg : String, stringa da aggiungere al nodo

insertData

Inserisci la stringa nel nodo

1
2
XmlCDATASection.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
XmlCDATASection.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
XmlCDATASection.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 XmlCDATASection.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
XmlCDATASection.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 XmlCDATASection.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 a 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 XmlCDATASection.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 XmlCDATASection.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 XmlCDATASection.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 la stessa della proprietà ownerDocument del nodo corrente.

insertAfter

Inserisci un nuovo nodo figlio dopo il nodo figlio esistente

1
2
XmlNode XmlCDATASection.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 la stessa della 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à 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 la stessa della 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à 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 XmlCDATASection.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 XmlCDATASection.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 XmlCDATASection.toJSON(String key = "");

Parametri di chiamata:

• key : stringa, non utilizzata

Risultato di ritorno:

• Value , restituisce un valore contenente JSON serializzabile