XmlDocument.ImportNode(XmlNode, Boolean) 方法

定義

命名空間:

System.Xml

組件:

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

組件:

System.Xml.ReaderWriter.dll

組件:

System.Xml.XmlDocument.dll

組件:

System.Xml.dll

組件:

netstandard.dll

從其他文件匯入節點至目前的文件。

public:
 virtual System::Xml::XmlNode ^ ImportNode(System::Xml::XmlNode ^ node, bool deep);

public virtual System.Xml.XmlNode ImportNode (System.Xml.XmlNode node, bool deep);

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

Public Overridable Function ImportNode (node As XmlNode, deep As Boolean) As XmlNode

參數

node

XmlNode

匯入的節點。

deep

Boolean

true 以執行深層複製；否則為 false。

傳回

XmlNode

匯入的 XmlNode。

例外狀況

InvalidOperationException

在無法匯入的節點類型上呼叫這個方法。

範例

下列範例會將書籍節點從第二個 XML 檔匯入原始 XML 檔。

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   
   //Create the XmlDocument.
   XmlDocument^ doc = gcnew XmlDocument;
   doc->LoadXml( "<bookstore><book genre='novel' ISBN='1-861001-57-5'><title>Pride And Prejudice</title></book></bookstore>" );
   
   //Create another XmlDocument which holds a list of books.
   XmlDocument^ doc2 = gcnew XmlDocument;
   doc2->Load( "books.xml" );
   
   //Import the last book node from doc2 into the original document.
   XmlNode^ newBook = doc->ImportNode( doc2->DocumentElement->LastChild, true );
   doc->DocumentElement->AppendChild( newBook );
   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()
  {
    //Create the XmlDocument.
    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<bookstore>" +
                "<book genre='novel' ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "</book>" +
                "</bookstore>");

    //Create another XmlDocument which holds a list of books.
    XmlDocument doc2 = new XmlDocument();
    doc2.Load("books.xml");

    //Import the last book node from doc2 into the original document.
    XmlNode newBook = doc.ImportNode(doc2.DocumentElement.LastChild, true);
    doc.DocumentElement.AppendChild(newBook);

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

Option Explicit
Option Strict

Imports System.IO
Imports System.Xml

Public Class Sample
    
    Public Shared Sub Main()
        'Create the XmlDocument.
        Dim doc As New XmlDocument()
        doc.LoadXml("<bookstore>" & _
                    "<book genre='novel' ISBN='1-861001-57-5'>" & _
                    "<title>Pride And Prejudice</title>" & _
                    "</book>" & _
                    "</bookstore>")
        
        'Create another XmlDocument which holds a list of books.
        Dim doc2 As New XmlDocument()
        doc2.Load("books.xml")
        
        'Import the last book node from doc2 into the original document.
        Dim newBook As XmlNode = doc.ImportNode(doc2.DocumentElement.LastChild, True)
        doc.DocumentElement.AppendChild(newBook)
        
        Console.WriteLine("Display the modified XML...")
        doc.Save(Console.Out)
    End Sub
End Class

此範例會使用 檔案 books.xml ，作為輸入。

<?xml version='1.0'?>
<!-- This file represents a fragment of a book store inventory database -->
<bookstore>
  <book genre="autobiography" publicationdate="1981" ISBN="1-861003-11-0">
    <title>The Autobiography of Benjamin Franklin</title>
    <author>
      <first-name>Benjamin</first-name>
      <last-name>Franklin</last-name>
    </author>
    <price>8.99</price>
  </book>
  <book genre="novel" publicationdate="1967" ISBN="0-201-63361-2">
    <title>The Confidence Man</title>
    <author>
      <first-name>Herman</first-name>
      <last-name>Melville</last-name>
    </author>
    <price>11.99</price>
  </book>
  <book genre="philosophy" publicationdate="1991" ISBN="1-861001-57-6">
    <title>The Gorgias</title>
    <author>
      <name>Plato</name>
    </author>
    <price>9.99</price>
  </book>
</bookstore>

備註

傳回的節點沒有父節點。 原始檔案不會改變或移除來源節點; ImportNode 會建立來源節點的複本。

匯入節點會 XmlNode 建立匯入檔擁有的物件，且與 Name NodeType 來源節點相同。 新的 物件也有與命名空間相關的屬性， Prefix (、 LocalName 和) NamespaceURI 。

視匯入節點的節點類型和參數的值 deep 而定，會視需要複製其他資訊。 如果 XML 或 HTML 來源片段從一份檔案複製到另一份檔，則此方法會嘗試鏡像預期的行為， (在 XML 案例中，這兩份檔可能會有不同的 DTD) 。

下表描述每個 XmlNodeType 的特定行為。

XmlNodeType	ImportNode (true)	ImportNode (false)
屬性	屬性 Specified 會在產生的 XmlAttribute 上設定為 true 。 來源 XmlAttribute 的子系會以遞迴方式匯入，而產生的節點會重新組合成對應的子樹。	參數 deep 不適用於 XmlAttribute 節點;它們一律會在匯入時搭配其子系。
CData	複製節點，包含其資料。	複製節點，包含其資料。
註解	複製節點，包含其資料。	複製節點，包含其資料。
DocumentFragment	來源節點的子代會遞迴匯入，而且產生的節點會重組以形成對應的樹狀子目錄。	會產生空 XmlDocumentFragment 的 。
DocumentType	複製節點，包含其 data.*	複製節點，包含其 data.*
項目	來源專案的子系及其指定的屬性節點會以遞迴方式匯入，而產生的節點會重新組合成對應的子樹。 注意：不會複製預設屬性。 如果要匯入的文件定義這個項目名稱的預設屬性，就會指派這些屬性。	來源專案的指定屬性節點會匯入，而產生的 XmlAttribute 節點會附加至產生的 XmlElement 。 注意：不會複製預設屬性。 如果要匯入的文件定義這個項目名稱的預設屬性，就會指派這些屬性。
EntityReference	因為來源和目的地檔可能有不同的定義實體，所以此方法只會複製 XmlEntityReference 節點。 不包括取代文字。 如果目的文件有定義的實體，就會指派它的值。	因為來源和目的地檔可能有不同的定義實體，所以此方法只會複製 XmlEntityReference 節點。 不包括取代文字。 如果目的文件有定義的實體，就會指派它的值。
ProcessingInstruction	從匯入的節點複製目標和資料值。	從匯入的節點複製目標和資料值。
Text	複製節點，包含其資料。	複製節點，包含其資料。
SignificantWhitespace	複製節點，包含其資料。	複製節點，包含其資料。
空白	複製節點，包含其資料。	複製節點，包含其資料。
XmlDeclaration	從匯入的節點複製目標和資料值。	從匯入的節點複製目標和資料值。
所有其他節點類型。	這些節點型別不會匯入。	這些節點型別不會匯入。

*雖然可以匯入 DocumentType 節點，但檔只能有一個 DocumentType。 如果檔目前有 DocumentType 節點，必須先移除它，才能新增新的節點。