Class Element

Öğe

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
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 doğrudan alt öğeleri olan tüm düğümler arasında belirtilen dizinde ekler.
cloneContent()	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.
getAllContent()	Content[]	{@code Element} düğümünün doğrudan alt öğeleri olan tüm düğümleri alır.
getAttribute(name)	Attribute	Belirtilen ada sahip ve ad alanı içermeyen bu Element düğümünün özelliğini 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 ve ad alanı içermeyen ilk Element düğümünü alır. Bu Element düğümünün doğrudan alt öğesidir.
getChild(name, namespace)	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.
getChildText(name)	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.
getChildText(name, namespace)	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.
getChildren()	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.
getChildren(name)	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.
getChildren(name, namespace)	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.
getContent(index)	Content	{@code Element} düğümünün doğrudan alt öğeleri olan tüm düğümler arasında belirtilen dizindeki düğümü alır.
getContentSize()	Integer	{@code Element} düğümünün doğrudan alt öğeleri 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, belgede 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 belirli bir ö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, belgede 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 veya dolaylı bir üst öğesi olup olmadığını 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 verilen özelliği (varsa) kaldırır.
removeAttribute(attributeName)	Boolean	Belirtilen ada sahip ve ad alanı içermeyen bu Element düğümünün özelliğini kaldırır (varsa).
removeAttribute(attributeName, namespace)	Boolean	Belirtilen ada ve ad alanına sahip bu Element düğümünün özelliğini (varsa) kaldırır.
removeContent()	Content[]	{@code Element} düğümünün doğrudan alt öğeleri olan tüm düğümleri kaldırır.
removeContent(content)	Boolean	Düğüm, {@code Element} düğümünün doğrudan alt öğesiyse söz konusu düğümü kaldırır.
removeContent(index)	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.
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, ad ve değer ile ad alanı olmadan ayarlar.
setAttribute(name, value, namespace)	Element	Bu Element düğümünün özelliğini, belirtilen 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ı belirler.
setText(text)	Element	Element düğümünün metin değerini ayarlar.

Ayrıntılı dokümanlar

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'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ü

---

addContent(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 ContentType'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ü

---

cloneContent()

{@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()

Düğümü, üst Element düğümünden ayırır. Nodun üst öğesi yoksa bu yöntemin etkisi olmaz.

Return

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

---

getAllContent()

{@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

---

getAttribute(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

---

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 belirli bir ad ve ad alanıyla ö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ünün tüm özelliklerini içeren bir dizi

---

getChild(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

---

getChild(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

---

getChildText(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.

---

getChildText(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.

---

getChildren()

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

---

getChildren(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

---

getChildren(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

---

getContent(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

---

getContentSize()

{@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ı

---

getDescendants()

{@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

---

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() kullanın.getPrefix() değerini kullanarak ön eki alı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 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ı

---

getParentElement()

Düğümün üst Element düğümünü alır. Nodun üst öğesi yoksa bu yöntem null 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ı ön eki yoksa getName() kullanın.

Return

String: Element düğümünün yerel adı ve ad alanı ön eki ([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, 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

---

isAncestorOf(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

---

isRootElement()

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

---

removeAttribute(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

---

removeAttribute(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
attributeName	String	özelliğin adı

Return

Boolean: Özellik mevcutsa ve kaldırıldıysa true, aksi takdirde false

---

removeAttribute(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
attributeName	String	özelliğin adı
namespace	Namespace	özelliğin ad alanı

Return

Boolean: Özellik mevcutsa ve kaldırıldıysa true, aksi takdirde false

---

removeContent()

{@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

---

removeContent(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 ContentType'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

---

removeContent(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

---

setAttribute(attribute)

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

Parametreler

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

Return

Element: Zincirleme için Element düğümü

---

setAttribute(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ü

---

setAttribute(name, value, namespace)

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

Parametreler

Ad	Tür	Açıklama
name	String	Ayarlanacak özelliğin adı
value	String	Ayarlanacak ö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 bir ad alanı ön eki ayarlamak üzere 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ı belirler.

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 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 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ü