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
1String XmlCDATASection.data;
length
Integer, il numero di caratteri contenuti nel nodo
1readonly Integer XmlCDATASection.length;
nodeType
Intero, restituisce il tipo di nodo del nodo
1readonly 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
1readonly 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
1String 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 )
1readonly XmlDocument XmlCDATASection.ownerDocument;
parentNode
XmlNode , può restituire il nodo padre di un nodo
1readonly XmlNode XmlCDATASection.parentNode;
childNodes
XmlNodeList , restituisce l'elenco dei nodi dei nodi figlio del nodo specificato
1readonly XmlNodeList XmlCDATASection.childNodes;
firstChild
XmlNode , restituisce il primo nodo figlio del nodo
1readonly XmlNode XmlCDATASection.firstChild;
lastChild
XmlNode , restituisce l'ultimo nodo figlio del nodo
1readonly 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
1readonly 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
1readonly XmlNode XmlCDATASection.nextSibling;
Funzione membro
splitText
Dividi il nodo di testo in due nodi in base all'offset specificato
1XmlText 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
2String 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
1XmlCDATASection.appendData(String arg);
Parametri di chiamata:
- arg : String, stringa da aggiungere al nodo
insertData
Inserisci la stringa nel nodo
1
2XmlCDATASection.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
2XmlCDATASection.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
3XmlCDATASection.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
1Boolean 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
1XmlCDATASection.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
1XmlNode 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
1String 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
1String 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
2XmlNode 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
2XmlNode 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
1XmlNode 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
2XmlNode XmlCDATASection.replaceChild(XmlNode newChild,
XmlNode oldChild);
Parametri di chiamata:
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
1XmlNode 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
1String 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
1Value XmlCDATASection.toJSON(String key = "");
Parametri di chiamata:
- key : stringa, non utilizzata
Risultato di ritorno:
- Value , restituisce un valore contenente JSON serializzabile