Bir XML Element düğümünün temsili.
// Adds up the values listed in a sample XML document and adds a new element // with the total. let xml = '<things>' + '<plates>12</plates>' + '<bowls>18</bowls>' + '<cups>25</cups>' + '</things>'; const document = XmlService.parse(xml); const root = document.getRootElement(); const items = root.getChildren(); let total = 0; for (let i = 0; i < items.length; i++) { total += Number(items[i].getText()); } const totalElement = XmlService.createElement('total').setText(total); root.addContent(totalElement); xml = XmlService.getPrettyFormat().format(document); Logger.log(xml);
Yöntemler
| Yöntem | Dönüş türü | Kısa açıklama |
|---|---|---|
add | Element | Belirtilen düğümü Element düğümünün son alt öğesi olarak ekler. |
add | Element | Belirtilen düğümü, Element düğümünün doğrudan alt öğeleri olan tüm düğümler arasında belirtilen dizinde ekler. |
clone | Content[] | {@code Element} düğümünün doğrudan alt öğeleri olan tüm düğümlerin eksiz kopyalarını oluşturur. |
detach() | Content | Düğümü, üst Element düğümünden ayırır. |
get | Content[] | {@code Element} düğümünün doğrudan alt öğeleri olan tüm düğümleri alır. |
get | Attribute | Belirtilen ada sahip ve ad alanı içermeyen bu Element düğümünün özelliğini alır. |
get | Attribute | Belirtilen ad ve ad alanına sahip bu Element düğümünün özelliğini alır. |
get | Attribute[] | Bu Element düğümünün tüm özelliklerini, dokümanda göründükleri sırayla alır. |
get | Element | Belirtilen ada sahip ve ad alanı içermeyen ilk Element düğümünü alır. Bu Element düğümünün doğrudan alt öğesidir. |
get | Element | Belirtilen ada ve ad alanına sahip olan ve bu Element düğümünün doğrudan alt öğesi olan ilk Element düğümünü alır. |
get | String | Düğüm, Element düğümünün doğrudan alt öğesiyse düğümün adının ve ad alanının olmadığı metin değerini alır. |
get | String | Nod, Element düğümünün doğrudan alt öğesiyse belirtilen ada ve ad alanına sahip düğümün metin değerini alır. |
get | Element[] | Bu Element düğümünün doğrudan alt öğeleri olan tüm Element düğümlerini, belgede göründükleri sırada alır. |
get | Element[] | Belirtilen ada sahip ve ad alanı içermeyen, bu Element düğümünün doğrudan alt öğeleri olan tüm Element düğümlerini dokümanda göründükleri sırayla alır. |
get | Element[] | Belirtilen ada ve ad alanına sahip olan ve bu Element düğümünün doğrudan alt öğeleri olan tüm Element düğümlerini, dokümanda göründükleri sırayla alır. |
get | Content | {@code Element} düğümünün doğrudan alt öğeleri olan tüm düğümler arasında belirtilen dizindeki düğümü alır. |
get | Integer | {@code Element} düğümünün doğrudan alt öğeleri olan düğümlerin sayısını alır. |
get | Content[] | {@code Element} düğümünün doğrudan veya dolaylı alt öğeleri olan tüm düğümleri, belgede göründükleri sırayla alır. |
get | Document | {@code Element} düğümünü içeren XML dokümanını alır. |
get | String | Element düğümünün yerel adını alır. |
get | Namespace | Element düğümünün ad alanını alır. |
get | Namespace | Element düğümü için belirli bir ön eke sahip ad alanını alır. |
get | Element | Düğümün üst Element düğümünü alır. |
get | String | Element düğümünün yerel adını ve ad alanı ön ekini [namespacePrefix]:[localName] biçiminde alır. |
get | String | Element düğümünün metin değerini alır. |
get | String | Düğümün doğrudan veya dolaylı alt öğeleri olan tüm düğümlerin metin değerini, belgede göründükleri sırayla alır. |
is | Boolean | Bu Element düğümünün, belirli bir Element düğümünün doğrudan veya dolaylı bir üst öğesi olup olmadığını belirler. |
is | Boolean | Element düğümünün dokümanın kök düğümü olup olmadığını belirler. |
remove | Boolean | Bu Element düğümü için verilen özelliği (varsa) kaldırır. |
remove | Boolean | Belirtilen ada sahip ve ad alanı içermeyen bu Element düğümünün özelliğini kaldırır (varsa). |
remove | Boolean | Belirtilen ada ve ad alanına sahip bu Element düğümünün özelliğini (varsa) kaldırır. |
remove | Content[] | {@code Element} düğümünün doğrudan alt öğeleri olan tüm düğümleri kaldırır. |
remove | Boolean | Düğüm, {@code Element} düğümünün doğrudan alt öğesiyse söz konusu düğümü kaldırır. |
remove | Content | {@code Element} düğümünün doğrudan alt öğeleri olan tüm düğümler arasında belirtilen dizindeki düğümü kaldırır. |
set | Element | Bu Element düğümü için belirtilen özelliği ayarlar. |
set | Element | Bu Element düğümünün özelliğini, ad ve değer ile ad alanı olmadan ayarlar. |
set | Element | Bu Element düğümünün özelliğini, belirtilen ad, değer ve ad alanıyla ayarlar. |
set | Element | Element düğümünün yerel adını ayarlar. |
set | Element | Element düğümünün ad alanını belirler. |
set | Element | Element düğümünün metin değerini ayarlar. |
Ayrıntılı dokümanlar
add Content(content)
Belirtilen düğümü Element düğümünün son alt öğesi olarak ekler. content bağımsız değişkeni, bir Element nesnesi veya Content'de listelenen bir türe karşılık gelen herhangi bir düğüm nesnesi olabilir.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
content | Content | eklenecek düğüm |
Return
Element: Zincirleme için Element düğümü
add Content(index, content)
Belirtilen düğümü, Element düğümünün doğrudan alt öğeleri olan tüm düğümler arasında belirtilen dizinde ekler. content bağımsız değişkeni, bir Element nesnesi veya Content'de listelenen bir türe karşılık gelen herhangi bir düğüm nesnesi olabilir.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
index | Integer | düğümün, Element düğümünün doğrudan alt öğeleri olan tüm düğümler arasına ekleneceği dizin |
content | Content | eklenecek düğüm |
Return
Element: Zincirleme için Element düğümü
clone Content()
{@code Element} düğümünün doğrudan alt öğeleri olan tüm düğümlerin eksiz kopyalarını oluşturur.
Return
Content[]: {@code Element} düğümünün doğrudan alt öğeleri olan tüm düğümlerin bağlı olmayan kopyalarından oluşan bir dizi
detach()
get All Content()
{@code Element} düğümünün doğrudan alt öğeleri olan tüm düğümleri alır.
Return
Content[]: {@code Element} düğümünün doğrudan alt öğeleri olan tüm düğümlerin dizisi
get Attribute(name)
Belirtilen ada sahip ve ad alanı içermeyen bu Element düğümünün özelliğini alır. Böyle bir özellik yoksa bu yöntem null değerini döndürür.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
name | String | özelliğin adı |
Return
Attribute: Özellik veya belirli bir ada ve ad alanına sahip özellik yoksa null
get Attribute(name, namespace)
get Attributes()
Bu Element düğümünün tüm özelliklerini, dokümanda göründükleri sırayla alır.
Return
Attribute[]: Bu Element düğümünün tüm özelliklerini içeren bir dizi
get Child(name)
Belirtilen ada sahip ve ad alanı içermeyen ilk Element düğümünü alır. Bu Element düğümünün doğrudan alt öğesidir. Böyle bir düğüm yoksa bu yöntem null döndürür.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
name | String | alt Element düğümünün adı |
Return
Element: Element düğümü veya verilen ada ve ad alanına sahip bir Element düğümü yoksa null
get Child(name, namespace)
Belirtilen ada ve ad alanına sahip olan ve bu Element düğümünün doğrudan alt öğesi olan ilk Element düğümünü alır. Böyle bir düğüm yoksa bu yöntem null döndürür.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
name | String | alt Element düğümünün adı |
namespace | Namespace | alt Element düğümünün ad alanı |
Return
Element: Element düğümü veya verilen ad ve ad alanında hemen ilk alt Element düğümü yoksa null
get Child Text(name)
Düğüm, Element düğümünün doğrudan alt öğesiyse düğümün adının ve ad alanının olmadığı metin değerini alır. Böyle bir düğüm yoksa bu yöntem null döndürür.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
name | String | alt düğümün adı |
Return
String: Alt öğenin metin değeridir. Belirtilen ada ve ad alanına sahip doğrudan bir alt öğe yoksa null değerini alır.
get Child Text(name, namespace)
Nod, Element düğümünün doğrudan alt öğesiyse belirtilen ada ve ad alanına sahip düğümün metin değerini alır. Böyle bir düğüm yoksa bu yöntem null döndürür.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
name | String | alt düğümün adı |
namespace | Namespace | alt düğümün ad alanı |
Return
String: Alt öğenin metin değeridir veya belirtilen ad ve ad alanını kullanan doğrudan bir alt öğe yoksa null değerini alır.
get Children()
Bu Element düğümünün doğrudan alt öğeleri olan tüm Element düğümlerini, belgede göründükleri sırada alır.
Return
Element[]: Bu Element düğümünün doğrudan alt öğeleri olan tüm Element düğümlerinin dizisi
get Children(name)
Belirtilen ada sahip ve ad alanı içermeyen, bu Element düğümünün doğrudan alt öğeleri olan tüm Element düğümlerini dokümanda göründükleri sırayla alır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
name | String | alt Element düğümlerinin adı |
Return
Element[]: Belirtilen ada sahip ve ad alanı içermeyen tüm Element düğümlerinin, bu Element düğümünün doğrudan alt öğeleri olan dizisi
get Children(name, namespace)
Belirtilen ada ve ad alanına sahip olan ve bu Element düğümünün doğrudan alt öğeleri olan tüm Element düğümlerini, dokümanda göründükleri sırayla alır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
name | String | alt Element düğümlerinin adı |
namespace | Namespace | alt Element düğümlerinin ad alanı |
Return
Element[]: Belirtilen ada ve ad alanına sahip, bu Element düğümünün doğrudan alt öğeleri olan tüm Element düğümlerinin dizisi
get Content(index)
{@code Element} düğümünün doğrudan alt öğeleri olan tüm düğümler arasında belirtilen dizindeki düğümü alır. Belirtilen dizinde düğüm yoksa bu yöntem null değerini döndürür.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
index | Integer | {@code Element} düğümünün doğrudan alt öğeleri olan tüm düğümler arasında düğümün dizini |
Return
Content: Düğüm veya belirtilen dizinde düğüm yoksa null
get Content Size()
{@code Element} düğümünün doğrudan alt öğeleri olan düğümlerin sayısını alır.
Return
Integer: {@code Element} düğümünün doğrudan alt öğeleri olan düğümlerin sayısı
get Descendants()
{@code Element} düğümünün doğrudan veya dolaylı alt öğeleri olan tüm düğümleri, belgede göründükleri sırayla alır.
Return
Content[]: {@code Element} düğümünün doğrudan veya dolaylı alt öğeleri olan tüm düğümlerin dizisi
get Document()
{@code Element} düğümünü içeren XML dokümanını alır.
Return
Document: {@code Element} düğümünü içeren doküman
get Name()
Element düğümünün yerel adını alır. Düğümün ad alanı öneki varsa get veya get kullanın.get değerini kullanarak ön eki alın.
Return
String: Element düğümünün yerel adı
get Namespace()
get Namespace(prefix)
Element düğümü için belirli bir ön eke sahip ad alanını alır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
prefix | String | ad alanının ön eki |
Return
Namespace: Element düğümü için belirli bir ön eke sahip ad alanı
get Parent Element()
get Qualified Name()
Element düğümünün yerel adını ve ad alanı ön ekini [namespacePrefix]:[localName] biçiminde alır. Düğümün ad alanı ön eki yoksa get kullanın.
Return
String: Element düğümünün yerel adı ve ad alanı ön eki ([namespacePrefix]:[localName] biçiminde)
get Text()
Element düğümünün metin değerini alır.
Return
String: Element düğümünün metin değeri
get Value()
Düğümün doğrudan veya dolaylı alt öğeleri olan tüm düğümlerin metin değerini, belgede göründükleri sırayla alır.
Return
String: Düğümün doğrudan veya dolaylı alt öğeleri olan tüm düğümlerin metin değeri
is Ancestor Of(other)
Bu Element düğümünün, belirli bir Element düğümünün doğrudan veya dolaylı bir üst öğesi olup olmadığını belirler.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
other | Element | diğer Element düğümü |
Return
Boolean: Bu Element düğümü, belirtilen Element düğümünün doğrudan veya dolaylı bir üst öğesiyse true; aksi takdirde false
is Root Element()
Element düğümünün dokümanın kök düğümü olup olmadığını belirler.
Return
Boolean: Element düğümü belgenin kök düğümüyse true, aksi takdirde false
remove Attribute(attribute)
Bu Element düğümü için verilen özelliği (varsa) kaldırır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
attribute | Attribute | özelliği |
Return
Boolean: Özellik mevcutsa ve kaldırıldıysa true, aksi takdirde false
remove Attribute(attributeName)
Belirtilen ada sahip ve ad alanı içermeyen bu Element düğümünün özelliğini kaldırır (varsa).
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
attribute | String | özelliğin adı |
Return
Boolean: Özellik mevcutsa ve kaldırıldıysa true, aksi takdirde false
remove Attribute(attributeName, namespace)
Belirtilen ada ve ad alanına sahip bu Element düğümünün özelliğini (varsa) kaldırır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
attribute | String | özelliğin adı |
namespace | Namespace | özelliğin ad alanı |
Return
Boolean: Özellik mevcutsa ve kaldırıldıysa true, aksi takdirde false
remove Content()
{@code Element} düğümünün doğrudan alt öğeleri olan tüm düğümleri kaldırır.
Return
Content[]: Kaldırılmadan önce {@code Element} düğümünün doğrudan alt öğeleri olan tüm düğümlerin dizisi
remove Content(content)
Düğüm, {@code Element} düğümünün doğrudan alt öğesiyse söz konusu düğümü kaldırır. content bağımsız değişkeni, bir Element nesnesi veya Content'de listelenen bir türe karşılık gelen herhangi bir düğüm nesnesi olabilir.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
content | Content | Kaldırılacağı düğüm |
Return
Boolean: Düğüm doğrudan alt öğeydiyse ve kaldırıldıysa true, aksi takdirde false
remove Content(index)
{@code Element} düğümünün doğrudan alt öğeleri olan tüm düğümler arasında belirtilen dizindeki düğümü kaldırır. Belirtilen dizinde düğüm yoksa bu yöntem null değerini döndürür.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
index | Integer | {@code Element} düğümünün doğrudan alt öğeleri olan tüm düğümler arasında düğümün dizini |
Return
Content: Kaldırılan düğüm veya belirtilen dizinde düğüm yoksa null
set Attribute(attribute)
set Attribute(name, value)
Bu Element düğümünün özelliğini, ad ve değer ile ad alanı olmadan ayarlar.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
name | String | Ayarlanacak özelliğin adı |
value | String | Ayarlanacak özelliğin değeri |
Return
Element: Zincirleme için Element düğümü
set Attribute(name, value, namespace)
set Name(name)
Element düğümünün yerel adını ayarlar. Düğüm için bir ad alanı ön eki ayarlamak üzere Xml ile birlikte set kullanın.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
name | String | Ayarlanacak yerel ad |
Return
Element: Zincirleme için Element düğümü
set Namespace(namespace)
set Text(text)
Element düğümünün metin değerini ayarlar. Düğüm zaten bir metin değeri veya alt düğüm içeriyorsa bu yöntem eski içeriğin üzerine yazar. Bunun yerine içerik eklemek veya mevcut içeriğe eklemek için add veya add kullanın.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
text | String | ayarlanacak metin |
Return
Element: Zincirleme için Element düğümü