InsertElement
在指定 XPath 插入 XML 元素。
语法
expression.InsertElement(xPath, xmlStr, index);
expression - 表示 ApiCustomXmlPart 类的变量。
参数
| 名称 | 必需/可选 | 数据类型 | 默认值 | 描述 |
|---|---|---|---|---|
| xPath | 必需 | string | 将插入新元素的父节点的 XPath。 | |
| xmlStr | 必需 | string | 要插入的 XML 字符串。 | |
| index | 可选 | number | 插入新 XML 元素的位置。如果省略，元素将作为最后一个子元素追加。 |
返回值
boolean
示例
向电子表格中存储的现有 XML 结构添加子元素。
// How do I nest a new node inside an XML block already saved in a spreadsheet?
// Expand stored XML data by appending a new element at a chosen location in a spreadsheet.
const worksheet = Api.GetActiveSheet();
const xmlManager = worksheet.GetCustomXmlParts();
const xmlString = "<content version='9.4' />";
const xml = xmlManager.Add(xmlString);
xml.InsertElement('/content', '<text>lorem</text>');
worksheet.GetRange('A1').SetValue('XML after insertion:');
worksheet.GetRange('A2').SetValue(xml.GetXml());