XmlNode.ReplaceChild(XmlNode, XmlNode) 方法

定義

命名空間:

System.Xml

組件:

System.Xml.dll, System.Xml.XmlDocument.dll

組件:

System.Xml.ReaderWriter.dll

組件:

System.Xml.XmlDocument.dll

組件:

System.Xml.dll

組件:

netstandard.dll

將子節點 oldChild 用 newChild 節點取代。

public:
 virtual System::Xml::XmlNode ^ ReplaceChild(System::Xml::XmlNode ^ newChild, System::Xml::XmlNode ^ oldChild);

public virtual System.Xml.XmlNode ReplaceChild (System.Xml.XmlNode newChild, System.Xml.XmlNode oldChild);

abstract member ReplaceChild : System.Xml.XmlNode * System.Xml.XmlNode -> System.Xml.XmlNode
override this.ReplaceChild : System.Xml.XmlNode * System.Xml.XmlNode -> System.Xml.XmlNode

Public Overridable Function ReplaceChild (newChild As XmlNode, oldChild As XmlNode) As XmlNode

參數

newChild

XmlNode

要放入子節點清單中的新節點。

oldChild

XmlNode

清單中要被取代的節點。

傳回

XmlNode

被取代的節點。

例外狀況

InvalidOperationException

這個節點的型別不允許 newChild 節點型別的子節點。

newChild 是這個節點的上階。

ArgumentException

newChild 由不同於建立這個節點的另一份文件所建立。

這個節點是唯讀的。

oldChild 不是這個節點的子節點。

範例

下列範例會取代 XML 檔中的 title 元素。

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   XmlDocument^ doc = gcnew XmlDocument;
   doc->LoadXml( "<book genre='novel' ISBN='1-861001-57-5'>"
   "<title>Pride And Prejudice</title>"
   "</book>" );
   XmlNode^ root = doc->DocumentElement;
   
   //Create a new title element.
   XmlElement^ elem = doc->CreateElement( "title" );
   elem->InnerText = "The Handmaid's Tale";
   
   //Replace the title element.
   root->ReplaceChild( elem, root->FirstChild );
   Console::WriteLine( "Display the modified XML..." );
   doc->Save( Console::Out );
}

using System;
using System.IO;
using System.Xml;

public class Sample {

  public static void Main() {

    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "</book>");

    XmlNode root = doc.DocumentElement;

    //Create a new title element.
    XmlElement elem = doc.CreateElement("title");
    elem.InnerText="The Handmaid's Tale";

    //Replace the title element.
    root.ReplaceChild(elem, root.FirstChild);

    Console.WriteLine("Display the modified XML...");
    doc.Save(Console.Out);
  }
}

Imports System.IO
Imports System.Xml

Public Class Sample
    
    Public Shared Sub Main()
        
        Dim doc As New XmlDocument()
        doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5'>" & _
                    "<title>Pride And Prejudice</title>" & _
                    "</book>")
        
        Dim root As XmlNode = doc.DocumentElement
        
        'Create a new title element.
        Dim elem As XmlElement = doc.CreateElement("title")
        elem.InnerText = "The Handmaid's Tale"
        
        'Replace the title element.
        root.ReplaceChild(elem, root.FirstChild)
        
        Console.WriteLine("Display the modified XML...")
        doc.Save(Console.Out)
    End Sub
End Class

備註

newChild如果 已在樹狀結構中，則會先移除。

如果 是從另一份檔建立的 newChild ，您可以使用 XmlDocument.ImportNode 將節點匯入至目前的檔。 匯入的節點接著可以傳遞至 ReplaceChild 方法。

給繼承者的注意事項

在衍生類別中覆寫 ReplaceChild 時，若要正確引發事件，您必須呼叫 ReplaceChild 基類的 方法。

另請參閱

• ImportNode(XmlNode, Boolean)