XmlComment.InsertBefore(IXmlNode, IXmlNode) 方法

定义

命名空间:

Windows.Data.Xml.Dom

在指定节点的左侧或列表末尾插入子节点。 此方法不适用于此类，将引发异常。

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 节点不是当前节点的子节点，则返回错误。

返回

IXmlNode

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

实现

InsertBefore(IXmlNode, IXmlNode)