Una rappresentazione di un nodo XML Element
.
// Adds up the values listed in a sample XML document and adds a new element with the total. var xml = '<things>' + '<plates>12</plates>' + '<bowls>18</bowls>' + '<cups>25</cups>' + '</things>'; var document = XmlService.parse(xml); var root = document.getRootElement(); var items = root.getChildren(); var total = 0; for (var i = 0; i < items.length; i++) { total += Number(items[i].getText()); } var totalElement = XmlService.createElement('total').setText(total); root.addContent(totalElement); xml = XmlService.getPrettyFormat().format(document); Logger.log(xml);
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
addContent(content) | Element | Aggiungi il nodo specificato come ultimo nodo figlio del nodo Element . |
addContent(index, content) | Element | Inserisce il nodo specificato nell'indice specificato tra tutti i nodi figlio immediati del
Element nodo. |
cloneContent() | Content[] | Crea copie non collegate di tutti i nodi secondari immediati del nodo {@code Element}. |
detach() | Content | Stacca il nodo dal relativo nodo Element principale. |
getAllContent() | Content[] | Ottiene tutti i nodi secondari immediati del nodo {@code Element}. |
getAttribute(name) | Attribute | Ottiene l'attributo per questo nodo Element con il nome specificato e nessuno spazio dei nomi. |
getAttribute(name, namespace) | Attribute | Recupera l'attributo per questo nodo Element con il nome e lo spazio dei nomi specificati. |
getAttributes() | Attribute[] | Recupera tutti gli attributi per questo nodo Element , nell'ordine in cui appaiono nel documento. |
getChild(name) | Element | Ottiene il primo nodo Element con il nome specificato e nessuno spazio dei nomi che è immediato
figlio di questo nodo Element . |
getChild(name, namespace) | Element | Ottiene il primo nodo Element con il nome e lo spazio dei nomi specificati.
figlio di questo nodo Element . |
getChildText(name) | String | Ottiene il valore di testo del nodo con il nome specificato e senza spazio dei nomi, se il nodo è
figlio immediato del nodo Element . |
getChildText(name, namespace) | String | Ottiene il valore di testo del nodo con il nome e lo spazio dei nomi specificati, se il nodo è una
figlio del nodo Element . |
getChildren() | Element[] | Recupera tutti i nodi Element secondari di questo nodo Element , in
nell'ordine in cui appaiono nel documento. |
getChildren(name) | Element[] | Ottiene tutti i nodi Element con il nome specificato e nessuno spazio dei nomi che sono elementi secondari immediati
di questo nodo Element , nell'ordine in cui vengono visualizzati nel documento. |
getChildren(name, namespace) | Element[] | Ottiene tutti i nodi Element con il nome e lo spazio dei nomi specificati che sono elementi secondari immediati di
questo nodo Element , nell'ordine in cui appaiono nel documento. |
getContent(index) | Content | Restituisce il nodo in corrispondenza dell'indice specificato tra tutti i nodi figlio immediati del Nodo {@code Element}. |
getContentSize() | Integer | Restituisce il numero di nodi secondari immediati del nodo {@code Element}. |
getDescendants() | Content[] | Ottiene tutti i nodi che sono figli diretti o indiretti del nodo {@code Element}, nell'ordine in cui vengono visualizzate nel documento. |
getDocument() | Document | Ottiene il documento XML che contiene il nodo {@code Element}. |
getName() | String | Ottiene il nome locale del nodo Element . |
getNamespace() | Namespace | Ottiene lo spazio dei nomi per il nodo Element . |
getNamespace(prefix) | Namespace | Recupera lo spazio dei nomi con il prefisso specificato per il nodo Element . |
getParentElement() | Element | Ottiene il nodo principale Element del nodo. |
getQualifiedName() | String | Ottiene il nome locale e il prefisso dello spazio dei nomi del nodo Element , nel formato [namespacePrefix]:[localName] . |
getText() | String | Ottiene il valore di testo del nodo Element . |
getValue() | String | Restituisce il valore testo di tutti i nodi che sono figli diretti o indiretti del nodo, nell'ordine appaiono nel documento. |
isAncestorOf(other) | Boolean | Determina se questo nodo Element è un elemento padre diretto o indiretto di un determinato nodo Element . |
isRootElement() | Boolean | Determina se il nodo Element è il nodo radice del documento. |
removeAttribute(attribute) | Boolean | Rimuove l'attributo specificato per questo nodo Element , se esiste. |
removeAttribute(attributeName) | Boolean | Rimuove l'attributo per questo nodo Element con il nome specificato e senza spazio dei nomi, se
di un attributo di questo tipo. |
removeAttribute(attributeName, namespace) | Boolean | Rimuove l'attributo per questo nodo Element con il nome e lo spazio dei nomi specificati, se presenti
esiste un attributo. |
removeContent() | Content[] | Rimuove tutti i nodi secondari immediati del nodo {@code Element}. |
removeContent(content) | Boolean | Rimuove il nodo specificato, se è un nodo secondario immediato del nodo {@code Element}. |
removeContent(index) | Content | Rimuove il nodo in corrispondenza dell'indice specificato tra tutti i nodi figlio immediati del Nodo {@code Element}. |
setAttribute(attribute) | Element | Imposta l'attributo specificato per questo nodo Element . |
setAttribute(name, value) | Element | Imposta l'attributo per questo nodo Element con il nome e il valore specificati, senza spazio dei nomi. |
setAttribute(name, value, namespace) | Element | Imposta l'attributo per questo nodo Element con il nome, il valore e lo spazio dei nomi specificati. |
setName(name) | Element | Imposta il nome locale del nodo Element . |
setNamespace(namespace) | Element | Imposta lo spazio dei nomi per il nodo Element . |
setText(text) | Element | Imposta il valore di testo del nodo Element . |
Documentazione dettagliata
addContent(content)
Aggiungi il nodo specificato come ultimo nodo figlio del nodo Element
. content
può essere un oggetto Element
o qualsiasi oggetto node che corrisponde a un tipo
elencato in ContentType
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
content | Content | il nodo per aggiungere |
Invio
Element
: il nodo Element
, per il concatenamento
addContent(index, content)
Inserisce il nodo specificato nell'indice specificato tra tutti i nodi figlio immediati del
Element
nodo. L'argomento content
può essere un oggetto Element
o qualsiasi
che corrisponde a un tipo elencato in ContentType
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
index | Integer | l'indice in cui inserire il nodo tra tutti i nodi figlio immediati
del nodo Element |
content | Content | il nodo per inserire |
Invio
Element
: il nodo Element
, per il concatenamento
cloneContent()
Crea copie non collegate di tutti i nodi secondari immediati del nodo {@code Element}.
Invio
Content[]
: un array di copie non collegate di tutti i nodi figlio immediati dello
Nodo {@code Element}
detach()
getAllContent()
Ottiene tutti i nodi secondari immediati del nodo {@code Element}.
Invio
Content[]
: un array di tutti i nodi secondari immediati del nodo {@code Element}.
getAttribute(name)
Ottiene l'attributo per questo nodo Element
con il nome specificato e nessuno spazio dei nomi. Se ci sono
non è un attributo di questo tipo, questo metodo restituisce null
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
name | String | il nome dell'attributo |
Invio
Attribute
: l'attributo o null
se non esiste un attributo con il nome specificato e non esiste
spazio dei nomi
getAttribute(name, namespace)
Recupera l'attributo per questo nodo Element
con il nome e lo spazio dei nomi specificati. Se c'è
di questo nodo, questo metodo restituisce null
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
name | String | il nome dell'attributo |
namespace | Namespace | lo spazio dei nomi dell'attributo |
Invio
Attribute
: l'attributo o null
se non esiste un attributo con il nome specificato e
spazio dei nomi
getAttributes()
Recupera tutti gli attributi per questo nodo Element
, nell'ordine in cui appaiono nel documento.
Invio
Attribute[]
: un array di tutti gli attributi per questo nodo Element
getChild(name)
Ottiene il primo nodo Element
con il nome specificato e nessuno spazio dei nomi che è immediato
figlio di questo nodo Element
. Se questo nodo non è presente, questo metodo restituisce null
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
name | String | il nome del nodo figlio Element |
Invio
Element
: il nodo Element
o null
se non esiste un nodo secondario immediato di Element
con il nome specificato e nessuno spazio dei nomi
getChild(name, namespace)
Ottiene il primo nodo Element
con il nome e lo spazio dei nomi specificati.
figlio di questo nodo Element
. Se questo nodo non è presente, questo metodo restituisce null
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
name | String | il nome del nodo figlio Element |
namespace | Namespace | lo spazio dei nomi del nodo figlio Element |
Invio
Element
- il nodo Element
o null
se non esiste un nodo secondario immediato Element
con il nome e lo spazio dei nomi specificati
getChildText(name)
Ottiene il valore di testo del nodo con il nome specificato e senza spazio dei nomi, se il nodo è
figlio immediato del nodo Element
. Se questo nodo non è presente, questo metodo restituisce
null
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
name | String | il nome del nodo figlio |
Invio
String
: il valore di testo del nodo figlio o null
se non esiste un nodo figlio immediato
con il nome specificato e senza spazio dei nomi
getChildText(name, namespace)
Ottiene il valore di testo del nodo con il nome e lo spazio dei nomi specificati, se il nodo è una
figlio del nodo Element
. Se questo nodo non è presente, questo metodo restituisce null
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
name | String | il nome del nodo figlio |
namespace | Namespace | lo spazio dei nomi del nodo figlio |
Invio
String
: il valore di testo del nodo figlio o null
se non esiste un nodo figlio immediato
con il nome e lo spazio dei nomi specificati
getChildren()
Recupera tutti i nodi Element
secondari di questo nodo Element
, in
nell'ordine in cui appaiono nel documento.
Invio
Element[]
: un array di tutti i nodi Element
secondari immediati di questo nodo Element
getChildren(name)
Ottiene tutti i nodi Element
con il nome specificato e nessuno spazio dei nomi che sono elementi secondari immediati
di questo nodo Element
, nell'ordine in cui vengono visualizzati nel documento.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
name | String | il nome dei nodi figlio Element |
Invio
Element[]
: un array di tutti i nodi Element
con il nome specificato e nessuno spazio dei nomi che sono
figlio immediati di questo nodo Element
getChildren(name, namespace)
Ottiene tutti i nodi Element
con il nome e lo spazio dei nomi specificati che sono elementi secondari immediati di
questo nodo Element
, nell'ordine in cui appaiono nel documento.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
name | String | il nome dei nodi figlio Element |
namespace | Namespace | lo spazio dei nomi dei nodi figlio Element |
Invio
Element[]
: un array di tutti i nodi Element
con il nome e lo spazio dei nomi specificati che sono
figlio immediati di questo nodo Element
getContent(index)
Restituisce il nodo in corrispondenza dell'indice specificato tra tutti i nodi figlio immediati del
Nodo {@code Element}. Se non sono presenti nodi nell'indice specificato, questo metodo restituisce null
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
index | Integer | l'indice del nodo tra tutti i nodi secondari immediati del Nodo {@code Element} |
Invio
Content
: il nodo o null
se non è presente alcun nodo nell'indice specificato
getContentSize()
Restituisce il numero di nodi secondari immediati del nodo {@code Element}.
Invio
Integer
: il numero di nodi secondari immediati del nodo {@code Element}
getDescendants()
Ottiene tutti i nodi che sono figli diretti o indiretti del nodo {@code Element}, nell'ordine in cui vengono visualizzate nel documento.
Invio
Content[]
: un array di tutti i nodi che sono figli diretti o indiretti del nodo {@code Element}.
getDocument()
Ottiene il documento XML che contiene il nodo {@code Element}.
Invio
Document
: il documento che contiene il nodo {@code Element}
getName()
Ottiene il nome locale del nodo Element
. Se il nodo ha un prefisso dello spazio dei nomi, usa getQualifiedName()
o getNamespace()
.Da getPrefix()
a
recupera il prefisso.
Invio
String
: il nome locale del nodo Element
getNamespace()
Ottiene lo spazio dei nomi per il nodo Element
.
Invio
Namespace
: lo spazio dei nomi per il nodo Element
.
getNamespace(prefix)
Recupera lo spazio dei nomi con il prefisso specificato per il nodo Element
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
prefix | String | il prefisso dello spazio dei nomi |
Invio
Namespace
: lo spazio dei nomi con il prefisso specificato per il nodo Element
getParentElement()
getQualifiedName()
Ottiene il nome locale e il prefisso dello spazio dei nomi del nodo Element
, nel formato [namespacePrefix]:[localName]
. Se il nodo non ha un prefisso dello spazio dei nomi, utilizza getName()
.
Invio
String
: il nome locale e il prefisso dello spazio dei nomi del nodo Element
, nel formato [namespacePrefix]:[localName]
getText()
Ottiene il valore di testo del nodo Element
.
Invio
String
: il valore di testo del nodo Element
getValue()
Restituisce il valore testo di tutti i nodi che sono figli diretti o indiretti del nodo, nell'ordine appaiono nel documento.
Invio
String
: il valore di testo di tutti i nodi che sono figli diretti o indiretti del nodo
isAncestorOf(other)
Determina se questo nodo Element
è un elemento padre diretto o indiretto di un determinato nodo Element
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
other | Element | l'altro nodo Element |
Invio
Boolean
- true
se questo nodo Element
è un elemento padre diretto o indiretto del nodo specificato
Element
nodo; false
in caso contrario
isRootElement()
Determina se il nodo Element
è il nodo radice del documento.
Invio
Boolean
: true
se il nodo Element
è il nodo principale del documento; false
se
non
removeAttribute(attribute)
Rimuove l'attributo specificato per questo nodo Element
, se esiste.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
attribute | Attribute | l'attributo |
Invio
Boolean
- true
se l'attributo esisteva ed è stato rimosso; false
in caso contrario
removeAttribute(attributeName)
Rimuove l'attributo per questo nodo Element
con il nome specificato e senza spazio dei nomi, se
di un attributo di questo tipo.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
attributeName | String | il nome dell'attributo |
Invio
Boolean
- true
se l'attributo esisteva ed è stato rimosso; false
in caso contrario
removeAttribute(attributeName, namespace)
Rimuove l'attributo per questo nodo Element
con il nome e lo spazio dei nomi specificati, se presenti
esiste un attributo.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
attributeName | String | il nome dell'attributo |
namespace | Namespace | lo spazio dei nomi dell'attributo |
Invio
Boolean
- true
se l'attributo esisteva ed è stato rimosso; false
in caso contrario
removeContent()
Rimuove tutti i nodi secondari immediati del nodo {@code Element}.
Invio
Content[]
: un array di tutti i nodi che erano secondari immediati del nodo {@code Element} prima di
sono stati rimossi
removeContent(content)
Rimuove il nodo specificato, se è un nodo secondario immediato del nodo {@code Element}. L'argomento content
può essere un oggetto Element
o qualsiasi oggetto nodo che corrisponde a un
tipo elencato in ContentType
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
content | Content | il nodo per rimuovere |
Invio
Boolean
: true
se il nodo era un elemento figlio immediato ed è stato rimosso; false
in caso contrario
removeContent(index)
Rimuove il nodo in corrispondenza dell'indice specificato tra tutti i nodi figlio immediati del
Nodo {@code Element}. Se non sono presenti nodi nell'indice specificato, questo metodo restituisce null
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
index | Integer | l'indice del nodo tra tutti i nodi secondari immediati del Nodo {@code Element} |
Invio
Content
: il nodo che è stato rimosso o null
se non sono presenti nodi nell'indice specificato
setAttribute(attribute)
setAttribute(name, value)
Imposta l'attributo per questo nodo Element
con il nome e il valore specificati, senza spazio dei nomi.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
name | String | il nome dell'attributo da impostare |
value | String | il valore dell'attributo da impostare |
Invio
Element
: il nodo Element
, per il concatenamento
setAttribute(name, value, namespace)
Imposta l'attributo per questo nodo Element
con il nome, il valore e lo spazio dei nomi specificati.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
name | String | il nome dell'attributo da impostare |
value | String | il valore dell'attributo da impostare |
namespace | Namespace | lo spazio dei nomi dell'attributo |
Invio
Element
: il nodo Element
, per il concatenamento
setName(name)
Imposta il nome locale del nodo Element
. Per impostare un prefisso dello spazio dei nomi per il nodo, utilizza
setNamespace(namespace)
in combinazione con XmlService.getNamespace(prefix, uri)
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
name | String | il nome locale da impostare |
Invio
Element
: il nodo Element
, per il concatenamento
setNamespace(namespace)
setText(text)
Imposta il valore di testo del nodo Element
. Se il nodo contiene già un valore di testo o
nodi figlio, questo metodo sovrascrive i contenuti precedenti. Per aggiungere o inserire contenuti,
usa addContent(content)
o addContent(index, content)
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
text | String | il testo da impostare |
Invio
Element
: il nodo Element
, per il concatenamento