XmlDocumentFragment.InsertBefore(IXmlNode, IXmlNode) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
在指定节点的左侧或列表末尾插入子节点。
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,则不创建任何对象。