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 の場合、オブジェクトは作成されません。