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