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，則不會建立任何物件。