การนําเสนอโหนด XML Element
// 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);
เมธอด
วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
---|---|---|
add | Element | ต่อโหนดที่ระบุเป็นโหนดย่อยสุดท้ายของโหนด Element |
add | Element | แทรกโหนดที่ระบุ ณ ดัชนีที่ระบุในบรรดาโหนดทั้งหมดที่เป็นโหนดย่อยโดยตรงของโหนด Element |
clone | Content[] | สร้างสำเนาที่ยังไม่ได้แนบของโหนดทั้งหมดที่เป็นโหนดย่อยโดยตรงของโหนด {@code Element} |
detach() | Content | แยกโหนดออกจากโหนด Element หลัก |
get | Content[] | รับโหนดทั้งหมดที่เป็นโหนดย่อยโดยตรงของโหนด {@code Element} |
get | Attribute | รับแอตทริบิวต์ของโหนด Element นี้ที่มีชื่อที่ระบุและไม่มีเนมสเปซ |
get | Attribute | รับแอตทริบิวต์ของโหนด Element นี้ที่มีชื่อและเนมสเปซที่ระบุ |
get | Attribute[] | รับแอตทริบิวต์ทั้งหมดของโหนด Element นี้ตามลําดับที่ปรากฏในเอกสาร |
get | Element | รับโหนด Element แรกที่มีชื่อที่ระบุและไม่มีเนมสเปซที่เป็นโหนดย่อยโดยตรงของโหนด Element นี้ |
get | Element | รับโหนด Element แรกที่มีชื่อและเนมสเปซที่ระบุ ซึ่งเป็นโหนดย่อยโดยตรงของโหนด Element นี้ |
get | String | รับค่าข้อความของโหนดที่มีชื่อที่ระบุและไม่มีเนมสเปซ หากโหนดเป็นโหนดย่อยโดยตรงของโหนด Element |
get | String | รับค่าข้อความของโหนดที่มีชื่อและเนมสเปซที่ระบุ หากโหนดนั้นเป็นโหนดย่อยโดยตรงของโหนด Element |
get | Element[] | รับโหนด Element ทั้งหมดที่เป็นโหนดย่อยโดยตรงของโหนด Element นี้ ตามลำดับที่ปรากฏในเอกสาร |
get | Element[] | รับโหนด Element ทั้งหมดที่มีชื่อที่ระบุและไม่มีเนมสเปซที่เป็นโหนดย่อยโดยตรงของโหนด Element นี้ตามลำดับที่ปรากฏในเอกสาร |
get | Element[] | รับโหนด Element ทั้งหมดที่มีชื่อและเนมสเปซที่ระบุ ซึ่งเป็นโหนดย่อยโดยตรงของโหนด Element นี้ ตามลำดับที่ปรากฏในเอกสาร |
get | Content | รับโหนดที่ดัชนีที่ระบุจากโหนดทั้งหมดที่เป็นโหนดย่อยโดยตรงของโหนด{@code Element} |
get | Integer | รับจํานวนโหนดที่เป็นโหนดย่อยโดยตรงของโหนด {@code Element} |
get | Content[] | รับโหนดทั้งหมดที่เป็นโหนดย่อยโดยตรงหรือโดยอ้อมของโหนด {@code Element} ตามลําดับที่ปรากฏในเอกสาร |
get | Document | รับเอกสาร XML ที่มีโหนด {@code Element} |
get | String | รับชื่อภายในของโหนด Element |
get | Namespace | รับเนมสเปซของโหนด Element |
get | Namespace | รับเนมสเปซที่มีคำนำหน้าที่กำหนดสำหรับโหนด Element |
get | Element | รับโหนด Element หลักของโหนด |
get | String | รับชื่อท้องถิ่นและคำนำหน้าเนมสเปซของโหนด Element ในรูปแบบ [namespacePrefix]:[localName] |
get | String | รับค่าข้อความของโหนด Element |
get | String | รับค่าข้อความของโหนดทั้งหมดที่เป็นโหนดย่อยโดยตรงหรือโดยอ้อมของโหนดนั้นๆ ตามลำดับที่ปรากฏในเอกสาร |
is | Boolean | ระบุว่าโหนด Element นี้เป็นโหนดหลักโดยตรงหรือโดยอ้อมของโหนด Element ที่ระบุ |
is | Boolean | ระบุว่าโหนด Element เป็นโหนดรากของเอกสารหรือไม่ |
remove | Boolean | นำแอตทริบิวต์ที่ระบุออกสำหรับโหนด Element นี้ หากมี |
remove | Boolean | นำแอตทริบิวต์สำหรับโหนด Element นี้ที่มีชื่อที่ระบุและไม่มีเนมสเปซออก หากมีแอตทริบิวต์ดังกล่าว |
remove | Boolean | นำแอตทริบิวต์สำหรับโหนด Element นี้ที่มีชื่อและเนมสเปซที่ระบุออก หากมีแอตทริบิวต์ดังกล่าว |
remove | Content[] | นำโหนดทั้งหมดที่เป็นโหนดย่อยโดยตรงของโหนด {@code Element} ออก |
remove | Boolean | นําโหนดที่ระบุออก หากโหนดนั้นเป็นโหนดย่อยโดยตรงของโหนด {@code Element} |
remove | Content | นำโหนดที่อยู่ที่อินเด็กซ์ที่ระบุออกจากโหนดทั้งหมดที่เป็นโหนดย่อยโดยตรงของโหนด{@code Element} |
set | Element | ตั้งค่าแอตทริบิวต์ที่ระบุสำหรับโหนด Element นี้ |
set | Element | ตั้งค่าแอตทริบิวต์สำหรับโหนด Element นี้ด้วยชื่อ ค่า และไม่มีเนมสเปซที่ระบุ |
set | Element | ตั้งค่าแอตทริบิวต์สําหรับโหนด Element นี้ด้วยชื่อ ค่า และเนมสเปซที่ระบุ |
set | Element | ตั้งค่าชื่อภายในของโหนด Element |
set | Element | ตั้งค่าเนมสเปซสําหรับโหนด Element |
set | Element | กำหนดค่าข้อความของโหนด Element |
เอกสารประกอบโดยละเอียด
add Content(content)
ต่อโหนดที่ระบุเป็นโหนดย่อยสุดท้ายของโหนด Element
content
อาร์กิวเมนต์อาจเป็นออบเจ็กต์ Element
หรือออบเจ็กต์โหนดใดก็ได้ที่สอดคล้องกับประเภทที่ระบุไว้ใน Content
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
content | Content | โหนดที่จะเพิ่มต่อท้าย |
รีเทิร์น
Element
— โหนด Element
สำหรับเชน
add Content(index, content)
แทรกโหนดที่ระบุ ณ ดัชนีที่ระบุในบรรดาโหนดทั้งหมดที่เป็นโหนดย่อยโดยตรงของโหนด Element
อาร์กิวเมนต์ content
อาจเป็นออบเจ็กต์ Element
หรือออบเจ็กต์โหนดใดก็ได้ที่สอดคล้องกับประเภทที่แสดงใน Content
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
index | Integer | ดัชนีที่จะแทรกโหนดในบรรดาโหนดทั้งหมดที่เป็นโหนดย่อยโดยตรงของโหนด Element |
content | Content | โหนดที่จะแทรก |
รีเทิร์น
Element
— โหนด Element
สำหรับเชน
clone Content()
สร้างสำเนาที่ยังไม่ได้แนบของโหนดทั้งหมดที่เป็นโหนดย่อยโดยตรงของโหนด {@code Element}
รีเทิร์น
Content[]
— อาร์เรย์ของสำเนาที่ยังไม่ได้แนบของโหนดทั้งหมดที่เป็นโหนดย่อยโดยตรงของโหนด {@code Element}
detach()
get All Content()
รับโหนดทั้งหมดที่เป็นโหนดย่อยโดยตรงของโหนด {@code Element}
รีเทิร์น
Content[]
— อาร์เรย์ของโหนดทั้งหมดที่เป็นโหนดย่อยโดยตรงของโหนด {@code Element}
get Attribute(name)
รับแอตทริบิวต์ของโหนด Element
นี้ที่มีชื่อที่ระบุและไม่มีเนมสเปซ หากไม่มีแอตทริบิวต์ดังกล่าว เมธอดนี้จะแสดงผลเป็น null
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
name | String | ชื่อแอตทริบิวต์ |
รีเทิร์น
Attribute
— แอตทริบิวต์ หรือ null
หากไม่มีแอตทริบิวต์ที่มีชื่อดังกล่าวและไม่มีเนมสเปซ
get Attribute(name, namespace)
get Attributes()
รับแอตทริบิวต์ทั้งหมดของโหนด Element
นี้ตามลําดับที่ปรากฏในเอกสาร
รีเทิร์น
Attribute[]
— อาร์เรย์ของแอตทริบิวต์ทั้งหมดสำหรับโหนด Element
นี้
get Child(name)
รับโหนด Element
แรกที่มีชื่อที่ระบุและไม่มีเนมสเปซที่เป็นโหนดย่อยโดยตรงของโหนด Element
นี้ หากไม่มีโหนดดังกล่าว เมธอดนี้จะแสดงผล null
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
name | String | ชื่อของโหนด Element ย่อย |
รีเทิร์น
Element
— โหนด Element
หรือ null
หากไม่มีโหนด Element
ย่อยโดยตรงที่มีชื่อที่ระบุและไม่มีเนมสเปซ
get Child(name, namespace)
รับโหนด Element
แรกที่มีชื่อและเนมสเปซที่ระบุ ซึ่งเป็นโหนดย่อยโดยตรงของโหนด Element
นี้ หากไม่มีโหนดดังกล่าว เมธอดนี้จะแสดงผล null
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
name | String | ชื่อของโหนด Element ย่อย |
namespace | Namespace | เนมสเปซของโหนด Element ย่อย |
รีเทิร์น
Element
— โหนด Element
หรือ null
หากไม่มีโหนด Element
ย่อยโดยตรงที่มีชื่อและเนมสเปซที่ระบุ
get Child Text(name)
รับค่าข้อความของโหนดที่มีชื่อที่ระบุและไม่มีเนมสเปซ หากโหนดเป็นโหนดย่อยโดยตรงของโหนด Element
หากไม่มีโหนดดังกล่าว เมธอดนี้จะแสดงผล null
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
name | String | ชื่อของโหนดย่อย |
รีเทิร์น
String
— ค่าข้อความของโหนดย่อย หรือ null
หากไม่มีโหนดย่อยโดยตรงที่มีชื่อที่ระบุและไม่มีเนมสเปซ
get Child Text(name, namespace)
รับค่าข้อความของโหนดที่มีชื่อและเนมสเปซที่ระบุ หากโหนดนั้นเป็นโหนดย่อยโดยตรงของโหนด Element
หากไม่มีโหนดดังกล่าว เมธอดนี้จะแสดงผล null
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
name | String | ชื่อของโหนดย่อย |
namespace | Namespace | เนมสเปซของโหนดย่อย |
รีเทิร์น
String
— ค่าข้อความของโหนดย่อย หรือ null
หากไม่มีโหนดย่อยโดยตรงที่มีชื่อและเนมสเปซที่ระบุ
get Children()
รับโหนด Element
ทั้งหมดที่เป็นโหนดย่อยโดยตรงของโหนด Element
นี้ ตามลำดับที่ปรากฏในเอกสาร
รีเทิร์น
Element[]
— อาร์เรย์ของโหนด Element
ทั้งหมดที่เป็นโหนดย่อยโดยตรงของโหนด Element
นี้
get Children(name)
รับโหนด Element
ทั้งหมดที่มีชื่อที่ระบุและไม่มีเนมสเปซที่เป็นโหนดย่อยโดยตรงของโหนด Element
นี้ตามลำดับที่ปรากฏในเอกสาร
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
name | String | ชื่อของโหนด Element ย่อย |
รีเทิร์น
Element[]
— อาร์เรย์ของโหนด Element
ทั้งหมดที่มีชื่อที่ระบุและไม่มีเนมสเปซ ซึ่งเป็นโหนดย่อยโดยตรงของโหนด Element
นี้
get Children(name, namespace)
รับโหนด Element
ทั้งหมดที่มีชื่อและเนมสเปซที่ระบุ ซึ่งเป็นโหนดย่อยโดยตรงของโหนด Element
นี้ ตามลำดับที่ปรากฏในเอกสาร
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
name | String | ชื่อของโหนด Element ย่อย |
namespace | Namespace | เนมสเปซของโหนด Element ย่อย |
รีเทิร์น
Element[]
— อาร์เรย์ของโหนด Element
ทั้งหมดที่มีชื่อและเนมสเปซที่ระบุ ซึ่งเป็นโหนดย่อยโดยตรงของโหนด Element
นี้
get Content(index)
รับโหนดที่ดัชนีที่ระบุจากโหนดทั้งหมดที่เป็นโหนดย่อยโดยตรงของโหนด{@code Element} หากไม่มีโหนดที่อินเด็กซ์ที่ระบุ เมธอดนี้จะแสดงผล null
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
index | Integer | ดัชนีของโหนดในบรรดาโหนดทั้งหมดที่เป็นโหนดย่อยโดยตรงของโหนด {@code Element} |
รีเทิร์น
Content
— โหนด หรือ null
หากไม่มีโหนดที่ดัชนีที่ระบุ
get Content Size()
รับจํานวนโหนดที่เป็นโหนดย่อยโดยตรงของโหนด {@code Element}
รีเทิร์น
Integer
— จํานวนโหนดที่เป็นโหนดย่อยโดยตรงของโหนด {@code Element}
get Descendants()
รับโหนดทั้งหมดที่เป็นโหนดย่อยโดยตรงหรือโดยอ้อมของโหนด {@code Element} ตามลําดับที่ปรากฏในเอกสาร
รีเทิร์น
Content[]
— อาร์เรย์ของโหนดทั้งหมดที่เป็นโหนดย่อยโดยตรงหรือโดยอ้อมของโหนด {@code Element}
get Document()
get Name()
รับชื่อภายในของโหนด Element
หากโหนดมีคํานําหน้าเนมสเปซ ให้ใช้ get
หรือ get
get
เพื่อรับคำนำหน้า
รีเทิร์น
String
— ชื่อภายในของโหนด Element
get Namespace()
get Namespace(prefix)
รับเนมสเปซที่มีคำนำหน้าที่กำหนดสำหรับโหนด Element
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
prefix | String | คำนำหน้าสำหรับเนมสเปซ |
รีเทิร์น
Namespace
— เนมสเปซที่มีคำนำหน้าที่กำหนดสำหรับโหนด Element
get Parent Element()
get Qualified Name()
รับชื่อท้องถิ่นและคำนำหน้าเนมสเปซของโหนด Element
ในรูปแบบ [namespacePrefix]:[localName]
หากโหนดไม่มีคำนำหน้าเนมสเปซ ให้ใช้ get
รีเทิร์น
String
— ชื่อภายในและคำนำหน้าเนมสเปซของโหนด Element
ในรูปแบบ [namespacePrefix]:[localName]
get Text()
รับค่าข้อความของโหนด Element
รีเทิร์น
String
— ค่าข้อความของโหนด Element
get Value()
รับค่าข้อความของโหนดทั้งหมดที่เป็นโหนดย่อยโดยตรงหรือโดยอ้อมของโหนดนั้นๆ ตามลำดับที่ปรากฏในเอกสาร
รีเทิร์น
String
— ค่าข้อความของโหนดทั้งหมดที่เป็นโหนดย่อยโดยตรงหรือโดยอ้อมของโหนด
is Ancestor Of(other)
ระบุว่าโหนด Element
นี้เป็นโหนดหลักโดยตรงหรือโดยอ้อมของโหนด Element
ที่ระบุ
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
other | Element | โหนด Element อีกโหนดหนึ่ง |
รีเทิร์น
Boolean
— true
หากโหนด Element
นี้เป็นโหนดหลักโดยตรงหรือโดยอ้อมของโหนด Element
ที่ระบุ false
หากไม่ใช่
is Root Element()
ระบุว่าโหนด Element
เป็นโหนดรากของเอกสารหรือไม่
รีเทิร์น
Boolean
— true
หากโหนด Element
เป็นโหนดรากของเอกสาร false
หากไม่ใช่
remove Attribute(attribute)
นำแอตทริบิวต์ที่ระบุออกสำหรับโหนด Element
นี้ หากมี
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
attribute | Attribute | แอตทริบิวต์ |
รีเทิร์น
Boolean
— true
หากแอตทริบิวต์มีอยู่แล้วและถูกนําออก false
หากไม่มี
remove Attribute(attributeName)
นำแอตทริบิวต์สำหรับโหนด Element
นี้ที่มีชื่อที่ระบุและไม่มีเนมสเปซออก หากมีแอตทริบิวต์ดังกล่าว
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
attribute | String | ชื่อแอตทริบิวต์ |
รีเทิร์น
Boolean
— true
หากแอตทริบิวต์มีอยู่แล้วและถูกนําออก false
หากไม่มี
remove Attribute(attributeName, namespace)
นำแอตทริบิวต์สำหรับโหนด Element
นี้ที่มีชื่อและเนมสเปซที่ระบุออก หากมีแอตทริบิวต์ดังกล่าว
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
attribute | String | ชื่อแอตทริบิวต์ |
namespace | Namespace | เนมสเปซของแอตทริบิวต์ |
รีเทิร์น
Boolean
— true
หากแอตทริบิวต์มีอยู่แล้วและถูกนําออก false
หากไม่มี
remove Content()
นำโหนดทั้งหมดที่เป็นโหนดย่อยโดยตรงของโหนด {@code Element} ออก
รีเทิร์น
Content[]
— อาร์เรย์ของโหนดทั้งหมดที่เป็นโหนดย่อยโดยตรงของโหนด {@code Element} ก่อนที่จะถูกนำออก
remove Content(content)
นําโหนดที่ระบุออก หากโหนดนั้นเป็นโหนดย่อยโดยตรงของโหนด {@code Element} อาร์กิวเมนต์ content
อาจเป็นออบเจ็กต์ Element
หรือออบเจ็กต์โหนดใดก็ได้ที่สอดคล้องกับประเภทที่แสดงใน Content
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
content | Content | โหนดที่จะนําออก |
รีเทิร์น
Boolean
— true
หากโหนดเป็นโหนดย่อยโดยตรงและถูกนําออก false
หากไม่ใช่
remove Content(index)
นำโหนดที่อยู่ที่อินเด็กซ์ที่ระบุออกจากโหนดทั้งหมดที่เป็นโหนดย่อยโดยตรงของโหนด{@code Element} หากไม่มีโหนดที่อินเด็กซ์ที่ระบุ เมธอดนี้จะแสดงผล null
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
index | Integer | ดัชนีของโหนดในบรรดาโหนดทั้งหมดที่เป็นโหนดย่อยโดยตรงของโหนด {@code Element} |
รีเทิร์น
Content
— โหนดที่ถูกนําออก หรือ null
หากไม่มีโหนดที่ดัชนีที่ระบุ
set Attribute(attribute)
set Attribute(name, value)
ตั้งค่าแอตทริบิวต์สำหรับโหนด Element
นี้ด้วยชื่อ ค่า และไม่มีเนมสเปซที่ระบุ
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
name | String | ชื่อแอตทริบิวต์ที่จะตั้งค่า |
value | String | ค่าของแอตทริบิวต์ที่จะตั้งค่า |
รีเทิร์น
Element
— โหนด Element
สำหรับเชน
set Attribute(name, value, namespace)
set Name(name)
ตั้งค่าชื่อภายในของโหนด Element
หากต้องการตั้งค่าคำนำหน้าเนมสเปซสำหรับโหนด ให้ใช้ set
ร่วมกับ Xml
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
name | String | ชื่อในเครื่องที่จะตั้ง |
รีเทิร์น
Element
— โหนด Element
สำหรับเชน
set Namespace(namespace)
set Text(text)
กำหนดค่าข้อความของโหนด Element
หากโหนดมีค่าข้อความหรือโหนดย่อยอยู่แล้ว วิธีการนี้จะเขียนทับเนื้อหาเก่า หากต้องการเพิ่มต่อท้ายหรือแทรกเนื้อหาแทน ให้ใช้ add
หรือ add
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
text | String | ข้อความที่จะตั้งค่า |
รีเทิร์น
Element
— โหนด Element
สำหรับเชน