Class Element

Öğe

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.
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	Verilen dizinde verilen düğümü, Element düğüm.
cloneContent()	Content[]	{@code Element} düğümünün en yakın alt öğeleri olan tüm düğümlerin ekli olmayan kopyalarını oluşturur.
detach()	Content	Düğümü üst Element düğümünden ayırır.
getAllContent()	Content[]	{@code Element} düğümünün ilk alt öğeleri olan tüm düğümleri alır.
getAttribute(name)	Attribute	Verilen ada sahip ve ad alanı olmadan bu Element düğümünün özelliğini alır.
getAttribute(name, namespace)	Attribute	Belirtilen ada ve ad alanına sahip bu Element düğümünün özelliğini alır.
getAttributes()	Attribute[]	Bu Element düğümüne ilişkin tüm özellikleri, dokümanda göründükleri sırayla alır.
getChild(name)	Element	Belirtilen ada sahip ilk Element düğümünü alır ve hemen bu Element düğümünün alt öğesidir.
getChild(name, namespace)	Element	Belirtilen ada ve ad alanına sahip ilk Element düğümünü alır ve bu Element düğümünün alt öğesidir.
getChildText(name)	String	Düğüm bir Element düğümünün hemen alt öğesidir.
getChildText(name, namespace)	String	Düğüm doğrudan bir düğümse verilen ada ve ad alanına sahip düğümün metin değerini alır Element düğümünün alt öğesidir.
getChildren()	Element[]	ElementElement ve bunların belgede görünmesini sağlayın.
getChildren(name)	Element[]	Verilen ada sahip ve hemen alt öğe olan ad alanı içermeyen tüm Element düğümlerini alır bu Element düğümünü dokümanda göründükleri sırayla görürsünüz.
getChildren(name, namespace)	Element[]	Verilen ada ve ad alanına sahip tüm Element düğümlerini alır ve bu düğümler bu Element düğümünü dokümanda göründükleri sırayla görürsünüz.
getContent(index)	Content	{@code Öğesi} düğümü.
getContentSize()	Integer	{@code Element} düğümünün ilk alt öğeleri olan düğümlerin sayısını alır.
getDescendants()	Content[]	{@code Element} düğümünün doğrudan veya dolaylı alt öğesi olan tüm düğümleri, görünür.
getDocument()	Document	{@code Öğesi} 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 eke sahip 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ı ön ekini [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 şu sırayla alır: bu öğeler dokümanda görünü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	Element düğümü için belirtilen özelliği (varsa) kaldırır.
removeAttribute(attributeName)	Boolean	Aşağıdaki durumda, belirtilen ada sahip ve ad alanı olmadan bu Element düğümünün özelliğini kaldırır böyle bir özellik bulunuyor.
removeAttribute(attributeName, namespace)	Boolean	Belirtilen ada ve ad alanına sahip bu Element düğümünün özelliğini kaldırır (bu durum söz konusuysa) bir özellik var.
removeContent()	Content[]	{@code Element} düğümünün ilk alt öğesi olan tüm düğümleri kaldırır.
removeContent(content)	Boolean	Düğüm, {@code Element} düğümünün ilk alt öğesiyse belirtilen düğümü kaldırır.
removeContent(index)	Content	{@code Öğesi} düğümü.
setAttribute(attribute)	Element	Bu Element düğümü için verilen özelliği ayarlar.
setAttribute(name, value)	Element	Bu Element düğümünün özelliğini verilen ada, değere ve ad alanına sahip olmadan ayarlar.
setAttribute(name, value, namespace)	Element	Bu Element düğümünün özelliğini verilen ad, değer ve ad ile 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şken bir Element nesnesi veya bir türe karşılık gelen herhangi bir düğüm nesnesi olabilir ContentType konumunda listelenir.

Parametreler

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

Return

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

---

addContent(index, content)

Verilen dizinde verilen düğümü, Element düğüm. content bağımsız değişkeni, Element nesnesi veya herhangi bir öğe olabilir ContentType içinde listelenen bir türe karşılık gelen düğüm nesnesi.

Parametreler

Ad	Tür	Açıklama
index	Integer	düğümün en yakın alt öğe olan tüm düğümler arasında ekleneceği dizin Element düğümünden
content	Content	eklenecek düğüm

Return

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

---

cloneContent()

{@code Element} düğümünün en yakın alt öğeleri olan tüm düğümlerin ekli olmayan kopyalarını oluşturur.

Return

Content[] — {@code Öğesi} düğümü

---

detach()

Düğümü üst Element düğümünden ayırır. Düğümün bir üst öğesi yoksa bu yöntemin hiçbir etkisi yoktur.

Return

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

---

getAllContent()

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

Return

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

---

getAttribute(name)

Verilen ada sahip ve ad alanı olmadan bu Element düğümünün özelliğini alır. Varsa 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 sahip bir özellik yoksa venull ad alanı

---

getAttribute(name, namespace)

Belirtilen ada ve ad alanına sahip bu Element düğümünün özelliğini alır. Varsa 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 — bu özellik; null ve belirtilen ada sahip ve ad alanı

---

getAttributes()

Bu Element düğümüne ilişkin tüm özellikleri, dokümanda göründükleri sırayla alır.

Return

Attribute[] — bu Element düğümü için tüm özelliklerin dizisi

---

getChild(name)

Belirtilen ada sahip ilk Element düğümünü alır ve hemen bu Element düğümünün alt öğesidir. 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 ve ad alanına sahip doğrudan alt Element düğümü yoksa null

---

getChild(name, namespace)

Belirtilen ada ve ad alanına sahip ilk Element düğümünü alır ve bu Element düğümünün alt öğesidir. 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 doğrudan alt Element düğümü yoksa null

---

getChildText(name)

Düğüm bir Element düğümünün hemen alt öğesidir. Böyle bir düğüm yoksa bu yöntem null

Parametreler

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

Return

String — alt düğümün metin değeri veya doğrudan alt düğüm yoksa null belirtilen ada sahip ve ad alanı olmadan

---

getChildText(name, namespace)

Düğüm doğrudan bir düğümse verilen ada ve ad alanına sahip düğümün metin değerini alır Element düğümünün alt öğesidir. 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 doğrudan alt düğüm yoksa null belirtilen ad ve ad alanına sahip olmalıdır.

---

getChildren()

ElementElement ve bunların belgede görünmesini sağlayın.

Return

Element[] - bu Element düğümün hemen alt öğeleri olan tüm Element düğümlerinin bir dizisi

---

getChildren(name)

Verilen ada sahip ve hemen alt öğe olan ad alanı içermeyen tüm Element düğümlerini alır bu Element düğümünü dokümanda göründükleri sırayla görürsünüz.

Parametreler

Ad	Tür	Açıklama
name	String	alt Element düğümlerinin adı

Return

Element[] — Belirtilen ada sahip veElement bu Element düğümün birinci alt öğeleri

---

getChildren(name, namespace)

Verilen ada ve ad alanına sahip tüm Element düğümlerini alır ve bu düğümler bu Element düğümünü dokümanda göründükleri sırayla görürsünüz.

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 tüm Element düğümlerinin yer aldığı bir dizidir: bu Element düğümün birinci alt öğeleri

---

getContent(index)

{@code Öğesi} düğümü. Belirtilen dizinde herhangi bir düğüm yoksa bu yöntem null değerini döndürür.

Parametreler

Ad	Tür	Açıklama
index	Integer	tüm düğümler arasında bu düğüme ait dizin {@code Öğesi} düğümü

Return

Content — düğüm veya belirtilen dizinde düğüm yoksa null

---

getContentSize()

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

Return

Integer — {@code Element} düğümünün birinci alt öğeleri olan düğümlerin sayısı

---

getDescendants()

{@code Element} düğümünün doğrudan veya dolaylı alt öğesi olan tüm düğümleri, görünür.

Return

Content[]: {@code Element} düğümünün doğrudan veya dolaylı alt öğeleri olan tüm düğümlerin dizisi

---

getDocument()

{@code Öğesi} 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() kullanın.getPrefix() - öneki al.

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 eke sahip ad alanını alır.

Parametreler

Ad	Tür	Açıklama
prefix	String	ad alanının ö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ı ön ekini [namespacePrefix]:[localName] biçiminde alır. Düğümün ad alanı öneki yoksa getName() politikasını kullanın.

Return

String — Element düğümünün yerel adı ve ad alanı ön eki, [namespacePrefix]:[localName] biçimindedir

---

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 şu sırayla alır: bu öğeler dokümanda görünür.

Return

String - düğümün doğrudan veya dolaylı alt öğeleri 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

Bu Element düğümü, belirtilen öğenin doğrudan veya dolaylı bir üst öğesiyse Boolean — true Element düğüm; 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; Şu durumda false: değil

---

removeAttribute(attribute)

Element düğümü için belirtilen özelliği (varsa) kaldırır.

Parametreler

Ad	Tür	Açıklama
attribute	Attribute	özellik

Return

Boolean — Özellik mevcutsa ve kaldırıldıysa true; Değilse false

---

removeAttribute(attributeName)

Aşağıdaki durumda, belirtilen ada sahip ve ad alanı olmadan bu Element düğümünün özelliğini kaldırır böyle bir özellik bulunuyor.

Parametreler

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

Return

Boolean — Özellik mevcutsa ve kaldırıldıysa true; Değilse false

---

removeAttribute(attributeName, namespace)

Belirtilen ada ve ad alanına sahip bu Element düğümünün özelliğini kaldırır (bu durum söz konusuysa) bir özellik var.

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; Değilse false

---

removeContent()

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

Return

Content[]: kaldırıldı

---

removeContent(content)

Düğüm, {@code Element} düğümünün ilk alt öğesiyse belirtilen düğümü kaldırır. content bağımsız değişkeni bir Element nesnesi veya türü (ContentType) altında listelenir.

Parametreler

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

Return

Boolean — Düğüm ilk sıradaki alt öğeyse ve kaldırıldıysa true; Değilse false

---

removeContent(index)

{@code Öğesi} düğümü. Belirtilen dizinde herhangi bir düğüm yoksa bu yöntem null değerini döndürür.

Parametreler

Ad	Tür	Açıklama
index	Integer	tüm düğümler arasında bu düğüme ait dizin {@code Öğesi} düğümü

Return

Content: Kaldırılan düğüm veya belirtilen dizinde düğüm yoksa null

---

setAttribute(attribute)

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

Parametreler

Ad	Tür	Açıklama
attribute	Attribute	belirlemek için

Return

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

---

setAttribute(name, value)

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

Parametreler

Ad	Tür	Açıklama
name	String	ayarlanacak özelliğin adı
value	String	kullanılacak özelliğin 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 ile ayarlar.

Parametreler

Ad	Tür	Açıklama
name	String	ayarlanacak özelliğin adı
value	String	kullanılacak özelliğin değeri
namespace	Namespace	ayarlanacak ö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 üzere setNamespace(namespace) ve XmlService.getNamespace(prefix, uri) ile birlikte.

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üğüm zaten bir metin değeri veya bu yöntem eski içeriğin üzerine yazılır. İçerik eklemek veya addContent(content) veya addContent(index, content) kullanın.

Parametreler

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

Return

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