Class Element

Öğe

XML Element düğümünü temsil eder.

// 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);

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
addContent(content)	Element	Belirtilen düğümü, Element düğümünün son alt öğesi olarak ekler.
addContent(index, content)	Element	Belirtilen düğümü, Element düğümünün hemen alt öğesi olan tüm düğümler arasında belirtilen dizine ekler.
cloneContent()	Content[]	{@code Element} düğümünün hemen alt öğeleri olan tüm düğümlerin eklenmemiş kopyalarını oluşturur.
detach()	Content	Düğümü üst Element düğümünden çıkarır.
getAllContent()	Content[]	{@code Element} düğümünün hemen alt öğesi olan tüm düğümleri alır.
getAttribute(name)	Attribute	Bu Element düğümünün özelliğini, belirtilen ada sahip olup ad alanı olmadan alır.
getAttribute(name, namespace)	Attribute	Belirtilen ad ve ad alanına sahip bu Element düğümünün özelliğini alır.
getAttributes()	Attribute[]	Bu Element düğümünün tüm özelliklerini, dokümanda göründükleri sırayla alır.
getChild(name)	Element	Belirtilen ada sahip ilk Element düğümünü alır ve bu Element düğümünün hemen alt öğesi olmayan ad alanı içermez.
getChild(name, namespace)	Element	Belirtilen ada ve ad alanına sahip, bu Element düğümünün hemen alt öğesi olan ilk Element düğümünü alır.
getChildText(name)	String	Düğüm, Element düğümünün doğrudan alt öğesiyse belirtilen ada sahip ve ad alanı olmadan düğümün metin değerini alır.
getChildText(name, namespace)	String	Düğüm, Element düğümünün en üst düzeylerinden biriyse belirtilen ada ve ad alanına sahip düğümün metin değerini alır.
getChildren()	Element[]	Bu Element düğümünün hemen alt öğeleri olan tüm Element düğümlerini, dokümanda göründükleri sırayla alır.
getChildren(name)	Element[]	Belirtilen ada sahip olan ve bu Element düğümünün hemen alt öğesi olmayan ad alanı olmayan tüm Element düğümlerini belgede göründükleri sırayla alır.
getChildren(name, namespace)	Element[]	Belirtilen ada ve ad alanına sahip olan ve bu Element düğümünün hemen alt öğeleri olan tüm Element düğümlerini belgede göründükleri sırayla alır.
getContent(index)	Content	{@code Element} düğümünün hemen alt öğesi olan tüm düğümler arasında belirtilen dizindeki düğümü alır.
getContentSize()	Integer	{@code Element} düğümünün hemen alt öğesi olan düğümlerin sayısını alır.
getDescendants()	Content[]	{@code Element} düğümünün doğrudan veya dolaylı alt öğeleri olan tüm düğümleri, dokümanda göründükleri sırayla alır.
getDocument()	Document	{@code Element} düğümünü içeren XML dokümanını alır.
getName()	String	Element düğümünün yerel adını alır.
getNamespace()	Namespace	Element düğümünün ad alanını alır.
getNamespace(prefix)	Namespace	Element düğümü için belirtilen ön ekle başlayan ad alanını alır.
getParentElement()	Element	Düğümün üst Element düğümünü alır.
getQualifiedName()	String	Element düğümünün yerel adını ve ad alanı önekini [namespacePrefix]:[localName] biçiminde alır.
getText()	String	Element düğümünün metin değerini alır.
getValue()	String	Düğümün doğrudan veya dolaylı alt öğeleri olan tüm düğümlerin metin değerini, dokümanda göründükleri sırayla alır.
isAncestorOf(other)	Boolean	Bu Element düğümünün, belirli bir Element düğümünün doğrudan mı yoksa dolaylı üst öğesi mi olduğunu belirler.
isRootElement()	Boolean	Element düğümünün, dokümanın kök düğümü olup olmadığını belirler.
removeAttribute(attribute)	Boolean	Bu Element düğümü için belirtilen özelliği (varsa) kaldırır.
removeAttribute(attributeName)	Boolean	Bu Element düğümünün özelliğini, belirtilen ada sahip olup ad alanı olmadan (böyle bir özellik varsa) kaldırır.
removeAttribute(attributeName, namespace)	Boolean	Bu Element düğümünün, belirtilen ad ve ad alanına sahip özelliğini (varsa) kaldırır.
removeContent()	Content[]	{@code Element} düğümünün hemen alt öğeleri olan tüm düğümleri kaldırır.
removeContent(content)	Boolean	Düğüm, {@code Element} düğümünün hemen bir alt öğesiyse belirtilen düğümü kaldırır.
removeContent(index)	Content	Belirtilen dizindeki düğümü, {@code Element} düğümünün hemen alt öğesi olan tüm düğümler arasından kaldırır.
setAttribute(attribute)	Element	Bu Element düğümü için belirtilen özelliği ayarlar.
setAttribute(name, value)	Element	Bu Element düğümünün özelliğini verilen ada ve değere sahip olup ad alanı olmadan ayarlar.
setAttribute(name, value, namespace)	Element	Bu Element düğümünün özelliğini verilen ad, değer ve ad alanıyla ayarlar.
setName(name)	Element	Element düğümünün yerel adını ayarlar.
setNamespace(namespace)	Element	Element düğümünün ad alanını ayarlar.
setText(text)	Element	Element düğümünün metin değerini ayarlar.

Ayrıntılı belgeler

addContent(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 ContentType içinde 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ü

---

addContent(index, content)

Belirtilen düğümü, Element düğümünün hemen alt öğesi olan tüm düğümler arasında belirtilen dizine ekler. content bağımsız değişkeni, bir Element nesnesi veya ContentType içinde 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 hemen alt öğesi olan tüm düğümler arasında ekleneceği dizin
content	Content	eklenecek düğüm

Return

Element — zincirleme için Element düğümü

---

cloneContent()

{@code Element} düğümünün hemen alt öğeleri olan tüm düğümlerin eklenmemiş kopyalarını oluşturur.

Return

Content[]: {@code Element} düğümünün hemen alt öğesi olan tüm düğümlerin eklenmemiş kopyalarından oluşan dizi

---

detach()

Düğümü üst Element düğümünden çıkarır. Düğümün bir üst öğesi yoksa bu yöntemin herhangi bir etkisi olmaz.

Return

Content - ayrılmış düğüm

---

getAllContent()

{@code Element} düğümünün hemen alt öğesi olan tüm düğümleri alır.

Return

Content[]: {@code Element} düğümünün hemen alt öğeleri olan tüm düğümlerin dizisi

---

getAttribute(name)

Bu Element düğümünün özelliğini, belirtilen ada sahip olup ad alanı olmadan 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 belirtilen ada ve ad alanına sahip bir özellik yoksa null

---

getAttribute(name, namespace)

Belirtilen ad ve ad alanına sahip bu Element düğümünün özelliğini alır. Böyle bir düğüm yoksa bu yöntem null değerini döndürür.

Parametreler

Ad	Tür	Açıklama
name	String	özelliğin adı
namespace	Namespace	özelliğin ad alanı

Return

Attribute: Özellik veya belirtilen ada ve ad alanına sahip bir özellik yoksa null

---

getAttributes()

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ü için tüm özellikleri içeren bir dizi

---

getChild(name)

Belirtilen ada sahip ilk Element düğümünü alır ve bu Element düğümünün hemen alt öğesi olmayan ad alanı içermez. Böyle bir düğüm yoksa bu yöntem null değerini 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 belirtilen ada sahip olan ve ad alanı olmayan birinci alt Element düğümü yoksa null

---

getChild(name, namespace)

Belirtilen ada ve ad alanına sahip, bu Element düğümünün hemen alt öğesi olan ilk Element düğümünü alır. Böyle bir düğüm yoksa bu yöntem null değerini 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 belirtilen ada ve ad alanına sahip bir alt Element düğümü yoksa null

---

getChildText(name)

Düğüm, Element düğümünün doğrudan alt öğesiyse belirtilen ada sahip ve ad alanı olmadan düğümün metin değerini alır. Böyle bir düğüm yoksa bu yöntem null değerini döndürür.

Parametreler

Ad	Tür	Açıklama
name	String	alt düğümün adı

Return

String - alt düğümün metin değeri veya belirtilen ada sahip ve ad alanı olmayan birinci alt düğüm yoksa null

---

getChildText(name, namespace)

Düğüm, Element düğümünün en üst düzeylerinden biriyse 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 değerini 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 düğümün metin değeri veya belirtilen ada ve ad alanına sahip bir alt düğüm yoksa null

---

getChildren()

Bu Element düğümünün hemen alt öğeleri olan tüm Element düğümlerini, dokümanda göründükleri sırayla alır.

Return

Element[]: Bu Element düğümünün hemen alt öğesi olan Element düğümünün tamamının bir dizisi

---

getChildren(name)

Belirtilen ada sahip olan ve bu Element düğümünün hemen alt öğesi olmayan ad alanı olmayan tüm Element düğümlerini belgede 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 olan ve bu Element düğümünün hemen alt öğesi olan ad alanı olmayan tüm Element düğümlerinden oluşan bir dizi

---

getChildren(name, namespace)

Belirtilen ada ve ad alanına sahip olan ve bu Element düğümünün hemen alt öğeleri olan tüm Element düğümlerini belgede 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 hemen alt öğeleri olan tüm Element düğümlerinden oluşan bir dizi

---

getContent(index)

{@code Element} düğümünün hemen alt öğesi 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 hemen alt öğesi olan tüm düğümler arasında düğümün dizini

Return

Content: Düğüm veya belirtilen dizinde düğüm yoksa null

---

getContentSize()

{@code Element} düğümünün hemen alt öğesi olan düğümlerin sayısını alır.

Return

Integer - {@code Element} düğümünün hemen alt öğesi olan düğümlerin sayısı

---

getDescendants()

{@code Element} düğümünün doğrudan veya dolaylı alt öğeleri olan tüm düğümleri, dokümanda 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

---

getDocument()

{@code Element} düğümünü içeren XML dokümanını alır.

Return

Document — {@code Element} düğümünü içeren doküman

---

getName()

Element düğümünün yerel adını alır. Düğümün ad alanı öneki varsa getQualifiedName() veya getNamespace() kodunu kullanın.öneki almak için getPrefix() kısayolunu kullanın.

Return

String - Element düğümünün yerel adı

---

getNamespace()

Element düğümünün ad alanını alır.

Return

Namespace: Element düğümünün ad alanı

---

getNamespace(prefix)

Element düğümü için belirtilen ön ekle başlayan ad alanını alır.

Parametreler

Ad	Tür	Açıklama
prefix	String	ad alanı öneki

Return

Namespace: Element düğümü için belirtilen ön eke sahip ad alanı

---

getParentElement()

Düğümün üst Element düğümünü alır. Düğümün bir üst öğesi yoksa bu yöntem null değerini döndürür.

Return

Element — üst Element düğümü

---

getQualifiedName()

Element düğümünün yerel adını ve ad alanı önekini [namespacePrefix]:[localName] biçiminde alır. Düğümde ad alanı öneki yoksa getName() değerini kullanın.

Return

String — Element düğümünün yerel adı ve ad alanı öneki ([namespacePrefix]:[localName] biçiminde)

---

getText()

Element düğümünün metin değerini alır.

Return

String — Element düğümünün metin değeri

---

getValue()

Düğümün doğrudan veya dolaylı alt öğeleri olan tüm düğümlerin metin değerini, dokümanda göründükleri sırayla alır.

Return

String - Düğümün doğrudan veya dolaylı alt öğesi olan tüm düğümlerin metin değeri

---

isAncestorOf(other)

Bu Element düğümünün, belirli bir Element düğümünün doğrudan mı yoksa dolaylı üst öğesi mi olduğunu 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; değilse false

---

isRootElement()

Element düğümünün, dokümanın kök düğümü olup olmadığını belirler.

Return

Boolean — Element düğümü dokümanın kök düğümüyse true; değilse false

---

removeAttribute(attribute)

Bu Element düğümü için belirtilen ö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; yoksa false

---

removeAttribute(attributeName)

Bu Element düğümünün özelliğini, belirtilen ada sahip olup ad alanı olmadan (böyle bir özellik varsa) kaldırır.

Parametreler

Ad	Tür	Açıklama
attributeName	String	özelliğin adı

Return

Boolean: Özellik mevcutsa ve kaldırıldıysa true; yoksa false

---

removeAttribute(attributeName, namespace)

Bu Element düğümünün, belirtilen ad ve ad alanına sahip özelliğini (varsa) kaldırır.

Parametreler

Ad	Tür	Açıklama
attributeName	String	özelliğin adı
namespace	Namespace	özelliğin ad alanı

Return

Boolean: Özellik mevcutsa ve kaldırıldıysa true; yoksa false

---

removeContent()

{@code Element} düğümünün hemen alt öğeleri olan tüm düğümleri kaldırır.

Return

Content[] — kaldırılmadan önce {@code Element} düğümünün hemen alt öğeleri olan tüm düğümlerin dizisi

---

removeContent(content)

Düğüm, {@code Element} düğümünün hemen bir alt öğesiyse belirtilen düğümü kaldırır. content bağımsız değişkeni, bir Element nesnesi veya ContentType içinde listelenen bir türe karşılık gelen herhangi bir düğüm nesnesi olabilir.

Parametreler

Ad	Tür	Açıklama
content	Content	kaldırılacak düğüm

Return

Boolean - Düğüm birinci çocuksa ve kaldırıldıysa true; değilse false

---

removeContent(index)

Belirtilen dizindeki düğümü, {@code Element} düğümünün hemen alt öğesi olan tüm düğümler arasından 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 hemen alt öğesi 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

---

setAttribute(attribute)

Bu Element düğümü için belirtilen özelliği ayarlar.

Parametreler

Ad	Tür	Açıklama
attribute	Attribute	özelliği ayarlamak için

Return

Element — zincirleme için Element düğümü

---

setAttribute(name, value)

Bu Element düğümünün özelliğini verilen ada ve değere sahip olup ad alanı olmadan ayarlar.

Parametreler

Ad	Tür	Açıklama
name	String	ayarlamak istediğiniz özelliğin adı
value	String	özelliğinin değeri

Return

Element — zincirleme için Element düğümü

---

setAttribute(name, value, namespace)

Bu Element düğümünün özelliğini verilen ad, değer ve ad alanıyla ayarlar.

Parametreler

Ad	Tür	Açıklama
name	String	ayarlamak istediğiniz özelliğin adı
value	String	özelliğinin değeri
namespace	Namespace	ayarlanan özelliğin ad alanı

Return

Element — zincirleme için Element düğümü

---

setName(name)

Element düğümünün yerel adını ayarlar. Düğüm için ad alanı öneki ayarlamak amacıyla XmlService.getNamespace(prefix, uri) ile birlikte setNamespace(namespace) kullanın.

Parametreler

Ad	Tür	Açıklama
name	String	ayarlanacak yerel ad

Return

Element — zincirleme için Element düğümü

---

setNamespace(namespace)

Element düğümünün ad alanını ayarlar.

Parametreler

Ad	Tür	Açıklama
namespace	Namespace	ayarlanacak ad alanı

Return

Element — zincirleme için Element düğümü

---

setText(text)

Element düğümünün metin değerini ayarlar. Düğümde zaten bir metin değeri veya herhangi bir alt düğüm varsa bu yöntem eski içeriğin üzerine yazılır. Bunun yerine içerik eklemek veya eklemek için addContent(content) veya addContent(index, content) kodunu kullanın.

Parametreler

Ad	Tür	Açıklama
text	String	ayarlanacak metin

Return

Element — zincirleme için Element düğümü