การแสดงโหนด 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|null | ยกเลิกการเชื่อมต่อโหนดจากโหนดระดับบนสุด Element |
get | Content[] | รับโหนดทั้งหมดที่เป็นโหนดย่อยโดยตรงของโหนด {@code Element} |
get | Attribute|null | รับแอตทริบิวต์สำหรับโหนด Element นี้ที่มีชื่อที่ระบุและไม่มีเนมสเปซ |
get | Attribute|null | รับแอตทริบิวต์สำหรับโหนด Element นี้ที่มีชื่อและเนมสเปซที่ระบุ |
get | Attribute[] | รับแอตทริบิวต์ทั้งหมดสำหรับโหนด Element นี้ตามลำดับที่ปรากฏในเอกสาร |
get | Element|null | รับElementโหนดแรกที่มีชื่อที่ระบุและไม่มีเนมสเปซซึ่งเป็นองค์ประกอบย่อย
โดยตรงของElementโหนดนี้ |
get | Element|null | รับโหนด Element แรกที่มีชื่อและเนมสเปซที่ระบุซึ่งเป็นบุตรElement ของโหนดนี้ |
get | String|null | รับค่าข้อความของโหนดที่มีชื่อที่ระบุและไม่มีเนมสเปซ หากโหนดเป็น
โหนดลูกโดยตรงของโหนด Element |
get | String|null | รับค่าข้อความของโหนดที่มีชื่อและเนมสเปซที่ระบุ หากโหนดเป็นองค์ประกอบย่อยโดยตรงของโหนด Element |
get | Element[] | รับโหนด Element ทั้งหมดที่เป็นโหนดลูกของโหนด Element นี้ใน
ลำดับที่ปรากฏในเอกสาร |
get | Element[] | รับโหนด Element ทั้งหมดที่มีชื่อที่ระบุและไม่มีเนมสเปซซึ่งเป็นองค์ประกอบย่อยโดยตรง
ของโหนด Element นี้ตามลำดับที่ปรากฏในเอกสาร |
get | Element[] | รับโหนด Element ทั้งหมดที่มีชื่อและเนมสเปซที่ระบุซึ่งเป็นโหนดย่อยโดยตรงของ
โหนด Element นี้ ตามลำดับที่ปรากฏในเอกสาร |
get | Content|null | รับโหนดที่ดัชนีที่ระบุในบรรดาโหนดทั้งหมดที่เป็นโหนดย่อยโดยตรงของโหนด {@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|null | รับโหนดแม่ของโหนด 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|null | นำโหนดที่ดัชนีที่ระบุออกจากโหนดทั้งหมดที่เป็นโหนดลูกโดยตรงของโหนด {@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 — แอตทริบิวต์ หรือ null หากไม่มีแอตทริบิวต์ที่มีชื่อที่ระบุและไม่มี
เนมสเปซ
get Attribute(name, namespace)
get Attributes()
รับแอตทริบิวต์ทั้งหมดสำหรับโหนด Element นี้ตามลำดับที่ปรากฏในเอกสาร
รีเทิร์น
Attribute[] — อาร์เรย์ของแอตทริบิวต์ทั้งหมดสำหรับโหนด Element นี้
get Child(name)
รับElementโหนดแรกที่มีชื่อที่ระบุและไม่มีเนมสเปซซึ่งเป็นองค์ประกอบย่อย
โดยตรงของElementโหนดนี้ หากไม่มีโหนดดังกล่าว เมธอดนี้จะแสดงผล null
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
name | String | ชื่อของโหนดElementลูก |
รีเทิร์น
Element|null - โหนด Element หรือ null หากไม่มีโหนด Element ลูกในทันทีที่มีชื่อที่ระบุและไม่มีเนมสเปซ
get Child(name, namespace)
รับโหนด Element แรกที่มีชื่อและเนมสเปซที่ระบุซึ่งเป็นบุตรElement ของโหนดนี้ หากไม่มีโหนดดังกล่าว เมธอดนี้จะแสดงผล null
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
name | String | ชื่อของโหนดElementลูก |
namespace | Namespace | เนมสเปซของโหนดElementย่อย |
รีเทิร์น
Element|null — โหนด Element หรือ null หากไม่มีโหนด Element ย่อยที่อยู่ใต้โหนดนั้นโดยตรงซึ่งมีชื่อและเนมสเปซที่ระบุ
get Child Text(name)
รับค่าข้อความของโหนดที่มีชื่อที่ระบุและไม่มีเนมสเปซ หากโหนดเป็น
โหนดลูกโดยตรงของโหนด Element หากไม่มีโหนดดังกล่าว เมธอดนี้จะแสดงผล
null
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
name | String | ชื่อของโหนดลูก |
รีเทิร์น
String|null — ค่าข้อความของโหนดลูก หรือ null หากไม่มีโหนดลูกที่อยู่ติดกัน
ที่มีชื่อที่ระบุและไม่มีเนมสเปซ
get Child Text(name, namespace)
รับค่าข้อความของโหนดที่มีชื่อและเนมสเปซที่ระบุ หากโหนดเป็นองค์ประกอบย่อยโดยตรงของโหนด Element หากไม่มีโหนดดังกล่าว เมธอดนี้จะแสดงผล null
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
name | String | ชื่อของโหนดลูก |
namespace | Namespace | เนมสเปซของโหนดย่อย |
รีเทิร์น
String|null — ค่าข้อความของโหนดลูก หรือ 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 — โหนด หรือ null หากไม่มีโหนดที่ดัชนีที่ระบุ
get Content Size()
รับจำนวนโหนดที่เป็นโหนดย่อยโดยตรงของโหนด {@code Element}
รีเทิร์น
Integer — จำนวนโหนดที่เป็นโหนดย่อยโดยตรงของโหนด {@code Element}
get Descendants()
รับโหนดทั้งหมดที่เป็นโหนดย่อยโดยตรงหรือโดยอ้อมของโหนด {@code Element} ตามลำดับที่ปรากฏในเอกสาร
รีเทิร์น
Content[] - อาร์เรย์ของโหนดทั้งหมดที่เป็นโหนดย่อยโดยตรงหรือโดยอ้อมของโหนด {@code Element}
get Document()
get Name()
รับชื่อในพื้นที่ของโหนด Element หากโหนดมีคำนำหน้าเนมสเปซ ให้ใช้ get หรือ getget เพื่อ
รับคำนำหน้า
รีเทิร์น
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 — โหนดที่ถูกนำออก หรือ 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 สำหรับการเชื่อมโยง