Object XmlElement

Gli oggetti XmlElement rappresentano gli elementi nei documenti XML

Eredità

Attributi dei membri

namespaceURI

String, l'URI dello spazio dei nomi dell'elemento query. Se il nodo selezionato non ha uno spazio dei nomi, questo attributo restituisce NULL

1
readonly String XmlElement.namespaceURI;

prefix

String, interroga e imposta il prefisso dello spazio dei nomi dell'elemento. Se il nodo selezionato non ha uno spazio dei nomi, questo attributo restituisce NULL

1
String XmlElement.prefix;

localName

String, il nome locale dell'elemento di query. Se il nodo selezionato non ha uno spazio dei nomi, questo attributo è equivalente a nodeName

1
readonly String XmlElement.localName;

tagName

Stringa, restituisce il nome del tag dell'elemento

1
readonly String XmlElement.tagName;

id

String, interroga e imposta l'attributo id dell'elemento

1
String XmlElement.id;

textContent

String, interroga e imposta il testo dell'elemento selezionato. Durante la query, restituisci i valori di tutti i nodi di testo nel nodo dell'elemento; durante l'impostazione, elimina tutti i nodi figlio e sostituiscili con un singolo nodo di testo.

1
String XmlElement.textContent;

innerHTML

String, interroga e imposta il testo HTML dell'elemento selezionato, valido solo in modalità html. Durante l'interrogazione, restituisci i codici HTML di tutti i nodi figlio nel nodo elemento; durante l'impostazione, elimina tutti i nodi figlio e sostituiscili con l'HTML specificato dopo la decodifica.

1
String XmlElement.innerHTML;

className

Stringa, interroga e imposta l'attributo di classe dell'elemento, valido solo in modalità html

1
String XmlElement.className;

attributes

XmlNamedNodeMap , restituisce la NamedNodeMap contenente gli attributi del nodo selezionato. Se il nodo selezionato non è un elemento, questo attributo restituisce NULL.

1
readonly XmlNamedNodeMap XmlElement.attributes;

nodeType

Intero, restituisce il tipo di nodo del nodo

1
readonly Integer XmlElement.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 XmlElement.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 XmlElement.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 XmlElement.ownerDocument;

parentNode

XmlNode , può restituire il nodo padre di un nodo

1
readonly XmlNode XmlElement.parentNode;

childNodes

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

1
readonly XmlNodeList XmlElement.childNodes;

firstChild

XmlNode , restituisce il primo nodo figlio del nodo

1
readonly XmlNode XmlElement.firstChild;

lastChild

XmlNode , restituisce l'ultimo nodo figlio del nodo

1
readonly XmlNode XmlElement.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 XmlElement.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 XmlElement.nextSibling;

Funzione membro

getAttribute

Interroga il valore di un attributo in base al nome

1
String XmlElement.getAttribute(String name);

Parametri di chiamata:

• name : stringa, specifica il nome dell'attributo della query

Risultato di ritorno:

• String , restituisce il valore della proprietà

getAttributeNS

Ottieni il valore dell'attributo tramite l'URI e il nome dello spazio dei nomi

1
2
String XmlElement.getAttributeNS(String namespaceURI,
    String localName);

Parametri di chiamata:

• namespaceURI : String, specifica l'URI dello spazio dei nomi della query
• localName : String, specifica il nome della proprietà da interrogare

Risultato di ritorno:

• String , restituisce il valore della proprietà

setAttribute

Crea o modifica una nuova proprietà

1
2
XmlElement.setAttribute(String name,
    String value);

Parametri di chiamata:

• name : String, specifica il nome della proprietà da impostare
• value : stringa, specifica il valore dell'attributo da impostare

Questo metodo imposta l'attributo specificato sul valore specificato. Se non è presente alcun attributo con il nome specificato, il metodo creerà un nuovo attributo

setAttributeNS

Crea o modifica gli attributi con lo spazio dei nomi

1
2
3
XmlElement.setAttributeNS(String namespaceURI,
    String qualifiedName,
    String value);

Parametri di chiamata:

• namespaceURI : String, specifica l'URI dello spazio dei nomi da impostare
• qualifiedName : stringa, specifica il nome dell'attributo da impostare
• value : stringa, specifica il valore dell'attributo da impostare

Questo metodo è simile al metodo setAttribute, tranne per il fatto che l'attributo da creare o impostare è specificato dall'URI dello spazio dei nomi e dal nome completo (costituito dal prefisso dello spazio dei nomi, dai due punti e dal nome locale nello spazio dei nomi). Oltre a modificare il valore di un attributo, utilizzando questo metodo è possibile modificare anche il prefisso dello spazio dei nomi dell'attributo

removeAttribute

Elimina l'attributo specificato per nome

1
XmlElement.removeAttribute(String name);

Parametri di chiamata:

• name : stringa, specifica il nome dell'attributo eliminato

removeAttributeNS

Elimina gli attributi specificati per spazio dei nomi e nome

1
2
XmlElement.removeAttributeNS(String namespaceURI,
    String localName);

Parametri di chiamata:

• namespaceURI : stringa, specifica l'URI dello spazio dei nomi da eliminare
• localName : String, specifica il nome dell'attributo eliminato

hasAttribute

Interroga se il nodo corrente ha un attributo con il nome specificato

1
Boolean XmlElement.hasAttribute(String name);

Parametri di chiamata:

• name : stringa, specifica il nome dell'attributo della query

Risultato di ritorno:

• Boolean , se il nodo dell'elemento corrente ha l'attributo specificato, restituisce true, altrimenti restituisce false

hasAttributeNS

Interroga se il nodo corrente ha attributi dello spazio dei nomi e del nome specificati

1
2
Boolean XmlElement.hasAttributeNS(String namespaceURI,
    String localName);

Parametri di chiamata:

• namespaceURI : String, specifica l'URI dello spazio dei nomi da interrogare
• localName : String, specifica il nome dell'attributo della query

Risultato di ritorno:

• Boolean , se il nodo dell'elemento corrente ha l'attributo specificato, restituisce true, altrimenti restituisce false

getElementsByTagName

Restituisce un XmlNodeList di tutti gli elementi con il nome specificato

1
XmlNodeList XmlElement.getElementsByTagName(String tagName);

Parametri di chiamata:

• tagName : String, il nome del tag da recuperare. Il valore "*" corrisponde a tutti i tag

Risultato di ritorno:

• XmlNodeList , una raccolta XmlNodeList di nodi XmlElement con tag specificati nella struttura ad albero dei nodi. L'ordine dei nodi degli elementi restituiti è l'ordine in cui appaiono nel documento di origine.

Questo metodo attraverserà i nodi discendenti dell'elemento specificato e restituirà un oggetto XmlNodeList del nodo XmlElement, che rappresenta tutti gli elementi del documento con il nome del tag specificato. L'ordine degli elementi nell'array restituito è l'ordine in cui appaiono nel codice sorgente del documento.

XmlDocument interfaccia XmlDocument definisce anche il metodo getElementsByTagName, che è simile a questo metodo, ma attraversa l'intero documento invece di attraversare i discendenti di un elemento.

getElementsByTagNameNS

Restituisce un XmlNodeList di tutti gli elementi con lo spazio dei nomi e il nome specificati

1
2
XmlNodeList XmlElement.getElementsByTagNameNS(String namespaceURI,
    String localName);

Parametri di chiamata:

• namespaceURI : String, specifica l'URI dello spazio dei nomi da interrogare
• localName : String, il nome dell'etichetta da recuperare. Il valore "*" corrisponde a tutti i tag

Risultato di ritorno:

• XmlNodeList , una raccolta XmlNodeList di nodi XmlElement con tag specificati nella struttura ad albero dei nodi. L'ordine dei nodi degli elementi restituiti è l'ordine in cui appaiono nel documento di origine.

Questo metodo è simile al metodo getElementsByTagName, tranne per il fatto che il nome del tag dell'elemento che si desidera ottenere viene specificato come una combinazione dell'URI dello spazio dei nomi e del nome locale definito nello spazio dei nomi.

getElementById

Restituisce l'elemento con l'attributo id specificato

1
XmlElement XmlElement.getElementById(String id);

Parametri di chiamata:

• id : String, id da recuperare

Risultato di ritorno:

• XmlElement , il nodo XmlElement con l'attributo id specificato nella struttura ad albero del nodo

Questo metodo attraverserà i nodi discendenti dell'elemento specificato e restituirà un oggetto nodo XmlElement che rappresenta il primo elemento del documento con l'attributo id specificato. .

XmlDocument interfaccia XmlDocument definisce anche il metodo getElementsByTagName, che è simile a questo metodo, ma attraversa l'intero documento invece di attraversare i discendenti di un elemento.

getElementsByClassName

Restituisce un elenco di nodi di tutti gli elementi con il nome di classe specificato

1
XmlNodeList XmlElement.getElementsByClassName(String className);

Parametri di chiamata:

• className : String, il nome della classe da recuperare

Risultato di ritorno:

• XmlNodeList , la raccolta XmlNodeList di nodi XmlElement con il nome di classe specificato nella struttura ad albero del documento. L'ordine dei nodi degli elementi restituiti è l'ordine in cui appaiono nel documento di origine.

Questo metodo restituirà un oggetto XmlNodeList (può essere elaborato come matrice di sola lettura), che archivia tutti i nodi XmlElement con il nome di classe specificato nel documento e l'ordine in cui vengono archiviati è l'ordine in cui vengono visualizzati nel documento di origine. XmlNodeList oggetto XmlNodeList è "live", ovvero, se un elemento con un nome di tag specificato viene aggiunto o eliminato nel documento, il suo contenuto verrà aggiornato automaticamente secondo necessità.

hasChildNodes

Interroga se sono presenti nodi figlio

1
Boolean XmlElement.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
XmlElement.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 XmlElement.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 XmlElement.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 XmlElement.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 XmlElement.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 XmlElement.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 XmlElement.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 XmlElement.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 la stessa della proprietà ownerDocument del nodo corrente.

removeChild

Rimuovi un nodo dall'elenco dei nodi figlio

1
XmlNode XmlElement.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 XmlElement.toString();

Risultato di ritorno:

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

toJSON

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

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

Parametri di chiamata:

• key : stringa, non utilizzata

Risultato di ritorno:

• Value , restituisce un valore contenente JSON serializzabile