IXmlNode.InsertBefore(IXmlNode, IXmlNode) 方法

定义

命名空间:

Windows.Data.Xml.Dom

在指定节点的左侧或列表末尾插入子节点。

public:
 IXmlNode ^ InsertBefore(IXmlNode ^ newChild, IXmlNode ^ referenceChild);

IXmlNode InsertBefore(IXmlNode const& newChild, IXmlNode const& referenceChild);

public IXmlNode InsertBefore(IXmlNode newChild, IXmlNode referenceChild);

function insertBefore(newChild, referenceChild)

Public Function InsertBefore (newChild As IXmlNode, referenceChild As IXmlNode) As IXmlNode

参数

newChild

IXmlNode

要插入的新节点的地址。 此处传递的节点必须是当前 XML DOM 文档节点的有效子级。 例如，如果当前节点是属性，则不能在 newChild 参数中传递另一个属性，因为特性不能将属性作为子属性。 如果 newChild 是DOCUMENT_FRAGMENT节点类型，则在 referenceChild 之前按顺序插入其所有子级。

如果 newChild 已在树中，则先将其删除，然后再重新插入 referenceChild 节点之前。 只读节点（如NODE_DOCUMENT_TYPE节点和NODE_ENTITY节点）不能在 newChild 参数中传递。

referenceChild

IXmlNode

引用节点。 指定的节点是 将 newChild 节点作为上一个同级插入到子列表中左侧的位置。 此处传递的节点必须是当前节点的子节点或 null。 如果值为 null，则会在子列表的末尾插入 newChild 节点。 如果 referenceChild 节点不是当前节点的子节点，则返回错误。

返回

IXmlNode

成功时，为已插入的子节点。 如果为 null，则不创建任何对象。