跳到主要内容

InsertElement

在指定 XPath 插入 XML 元素。

语法

expression.InsertElement(xPath, xmlStr, index);

expression - 表示 ApiCustomXmlPart 类的变量。

参数

名称必需/可选数据类型默认值描述
xPath必需string将插入新元素的父节点的 XPath。
xmlStr必需string要插入的 XML 字符串。
index可选number插入新 XML 元素的位置。如果省略,元素将作为最后一个子元素追加。

返回值

boolean

示例

此示例展示如何向自定义 XML 部件中插入新的 XML 元素。

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