XmlDocumentFragment.InsertBefore(IXmlNode, IXmlNode) 方法

定义

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

public:
 virtual IXmlNode ^ InsertBefore(IXmlNode ^ newChild, IXmlNode ^ referenceChild) = InsertBefore;
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 节点不是当前节点的子节点,则返回错误。

返回

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

实现

适用于