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