ObjectXmlComment

Gli oggetti XmlComment rappresentano il contenuto dei nodi di commento nel documento

Il nodo XmlComment rappresenta un commento in un documento XML. Usato daXmlCharacterDataL'attributo data ereditato dall'interfaccia o utilizzando il fileXmlNodeL'attributo nodeValue ereditato dall'interfaccia può accedere al contenuto dell'annotazione. (cioè il testo tra ). Usato daXmlCharacterDataVari metodi ereditati dall'interfaccia possono operare sul contenuto dell'annotazione.

utilizzoXmlDocument.createComment() per creare un oggetto di annotazione.

rapporto ereditario

proprietà dei membri

data

String, il testo contenuto in questo nodo

1
String XmlComment.data;

---

length

Intero, il numero di caratteri contenuti in questo nodo

1
readonly Integer XmlComment.length;

---

nodeType

Intero, restituisce il tipo di nodo del nodo

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

1
readonly String XmlComment.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

1
String XmlComment.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)

1
readonly XmlDocument XmlComment.ownerDocument;

---

parentNode

XmlNode, può restituire il nodo genitore di un nodo

1
readonly XmlNode XmlComment.parentNode;

---

childNodes

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

1
readonly XmlNodeList XmlComment.childNodes;

---

children

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

1
readonly XmlNodeList XmlComment.children;

---

firstChild

XmlNode, restituisce il primo nodo figlio del nodo

1
readonly XmlNode XmlComment.firstChild;

---

lastChild

XmlNode, restituisce l'ultimo nodo figlio del nodo

1
readonly XmlNode XmlComment.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.

1
readonly XmlNode XmlComment.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.

1
readonly XmlNode XmlComment.nextSibling;

---

firstElementChild

XmlNode, restituisce il primo nodo dell'elemento figlio del nodo

1
readonly XmlNode XmlComment.firstElementChild;

---

lastElementChild

XmlNode, restituisce l'ultimo nodo dell'elemento figlio del nodo

1
readonly XmlNode XmlComment.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.

1
readonly XmlNode XmlComment.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.

1
readonly XmlNode XmlComment.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.

1
String XmlComment.textContent;

funzione membro

substringData

Estrai la sottostringa dal nodo

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

1
XmlComment.appendData(String arg);

Parametri di chiamata:

• arg: String, la stringa da aggiungere al nodo

---

insertData

Inserisci la stringa nel nodo

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

1
Boolean XmlComment.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

1
XmlComment.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

1
XmlNode XmlComment.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

1
String XmlComment.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

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

1
XmlNode XmlComment.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
2
XmlNode XmlComment.replaceChild(XmlNode newChild,
    XmlNode oldChild);

Parametri di chiamata:

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

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

1
XmlNode XmlComment.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.

1
String XmlComment.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.

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

Parametri di chiamata:

• key: Stringa, non utilizzata

Risultati restituiti:

• Value, restituisce un valore contenente JSON serializzabile