XmlDocument.CreateNode 方法

參考

定義

命名空間:: System.Xml

組件:: System.Xml.dll, System.Xml.XmlDocument.dll

組件:: System.Xml.ReaderWriter.dll

組件:: System.Xml.XmlDocument.dll

組件:: System.Xml.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

建立 XmlNode。

多載

CreateNode(String, String, String)	建立具有指定節點類型、Name 和 NamespaceURI 的 XmlNode。
CreateNode(XmlNodeType, String, String)	建立具有指定的 XmlNodeType、Name 和 NamespaceURI 的 XmlNode。
CreateNode(XmlNodeType, String, String, String)	建立具有指定之 XmlNodeType、Prefix、Name 和 NamespaceURI 的 XmlNode。

CreateNode(String, String, String)

Source:: XmlDocument.cs

Source:: XmlDocument.cs

Source:: XmlDocument.cs

建立具有指定節點類型、Name 和 NamespaceURI 的 XmlNode。

public:
 virtual System::Xml::XmlNode ^ CreateNode(System::String ^ nodeTypeString, System::String ^ name, System::String ^ namespaceURI);

public virtual System.Xml.XmlNode CreateNode (string nodeTypeString, string name, string namespaceURI);

public virtual System.Xml.XmlNode CreateNode (string nodeTypeString, string name, string? namespaceURI);

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

Public Overridable Function CreateNode (nodeTypeString As String, name As String, namespaceURI As String) As XmlNode

參數

nodeTypeString: String

新節點的 XmlNodeType 的字串版本。這個參數必須是下表中所列的其中一個值。

name: String

新節點的限定名稱。如果名稱包含冒號，將會剖析為 Prefix 和 LocalName 元件。

namespaceURI: String

新節點的命名空間 URI。

傳回

XmlNode

新的 XmlNode。

例外狀況

ArgumentException

未提供名稱且 XmlNodeType 需要名稱；或者 nodeTypeString 不是下列字串之一。

範例

下列範例會建立新的專案，並將它插入檔中。

#using <System.Xml.dll>

using namespace System;
using namespace System::Xml;
int main()
{
   XmlDocument^ doc = gcnew XmlDocument;
   doc->LoadXml( "<book>  <title>Oberon's Legacy</title>  <price>5.95</price></book>" );
   
   // Create a new element node.
   XmlNode^ newElem = doc->CreateNode( "element", "pages", "" );
   newElem->InnerText = "290";
   Console::WriteLine( "Add the new element to the document..." );
   XmlElement^ root = doc->DocumentElement;
   root->AppendChild( newElem );
   Console::WriteLine( "Display the modified XML document..." );
   Console::WriteLine( doc->OuterXml );
}

using System;
using System.Xml;

public class Sample {

  public static void Main() {

       XmlDocument doc = new XmlDocument();
       doc.LoadXml("<book>" +
                   "  <title>Oberon's Legacy</title>" +
                   "  <price>5.95</price>" +
                   "</book>");

       // Create a new element node.
       XmlNode newElem = doc.CreateNode("element", "pages", "");
       newElem.InnerText = "290";

       Console.WriteLine("Add the new element to the document...");
       XmlElement root = doc.DocumentElement;
       root.AppendChild(newElem);

       Console.WriteLine("Display the modified XML document...");
       Console.WriteLine(doc.OuterXml);
   }
 }

Imports System.Xml

public class Sample 

  public shared sub Main() 

       Dim doc as XmlDocument = new XmlDocument()
       doc.LoadXml("<book>" & _
                   "  <title>Oberon's Legacy</title>" & _
                   "  <price>5.95</price>" & _
                   "</book>") 
 
       ' Create a new element node.
       Dim newElem as XmlNode = doc.CreateNode("element", "pages", "")  
       newElem.InnerText = "290"
     
       Console.WriteLine("Add the new element to the document...")
       Dim root as XmlElement = doc.DocumentElement
       root.AppendChild(newElem)
     
       Console.WriteLine("Display the modified XML document...")
       Console.WriteLine(doc.OuterXml)
   end sub
end class

備註

參數 nodeTypeString 區分大小寫，且必須是下表中的其中一個值。

nodeTypeString	XmlNodeType
屬性	屬性
cdatasection	CDATA
comment	註解
文件	文件
documentfragment	DocumentFragment
documenttype	DocumentType
element	項目
entityreference	EntityReference
processinginstruction	ProcessingInstruction
significantwhitespace	SignificantWhitespace
text	Text
whitespace	空白

雖然這個方法會在檔的內容中建立新的物件，但不會自動將新物件加入檔樹狀結構。若要新增物件，您必須明確呼叫其中一個節點插入方法。

下表顯示根據 W3C Extensible Markup Language (XML) 1.0 建議，在另一個 NodeType[column] 內允許哪些 NodeType[row] 。

	文件	DocumentType	XmlDeclaration	項目	屬性	Text	CDATA	標記	EntityReference
`Document`	否	否	否	否	否	否	否	否	否
`DocumentType`	是	否	否	否	否	否	否	否	否
`XmlDeclaration`	是*	否	否	否	否	否	否	否	否
`Element`	是	否	否	是	否	否	否	否	是的***
`Attribute`	否	否	否	是的****	否	否	否	否	否
`Text`	否	否	否	是	是	否	否	否	是
`CDATA`	否	否	否	是	否	否	否	否	是的***
`Markup**`	是	否	否	是	否	否	否	否	否
`EntityReference`	否	否	否	是	是	否	否	否	是

* XmlDeclaration 節點必須是檔節點的第一個子節點。

** 標記包含 ProcessingInstruction 和 Comment 節點。

只有在 EntityReference 節點不是 Attribute 節點的子節點時，EntityReference 節點才允許元素和 CDATA 節點。

屬性不是元素節點的子系。屬性包含在屬於 Element 節點的屬性集合內。

此方法是檔物件模型 (DOM) Microsoft延伸模組。

適用於

CreateNode(XmlNodeType, String, String)

Source:: XmlDocument.cs

Source:: XmlDocument.cs

Source:: XmlDocument.cs

建立具有指定的 XmlNodeType、Name 和 NamespaceURI 的 XmlNode。

public:
 virtual System::Xml::XmlNode ^ CreateNode(System::Xml::XmlNodeType type, System::String ^ name, System::String ^ namespaceURI);

public virtual System.Xml.XmlNode CreateNode (System.Xml.XmlNodeType type, string name, string namespaceURI);

public virtual System.Xml.XmlNode CreateNode (System.Xml.XmlNodeType type, string name, string? namespaceURI);

abstract member CreateNode : System.Xml.XmlNodeType * string * string -> System.Xml.XmlNode
override this.CreateNode : System.Xml.XmlNodeType * string * string -> System.Xml.XmlNode

Public Overridable Function CreateNode (type As XmlNodeType, name As String, namespaceURI As String) As XmlNode

參數

type: XmlNodeType

新節點的 XmlNodeType。

name: String

新節點的限定名稱。如果名稱包含冒號，將會剖析為 Prefix 和 LocalName 元件。

namespaceURI: String

新節點的命名空間 URI。

傳回

XmlNode

新的 XmlNode。

例外狀況

ArgumentException

未提供名稱且 XmlNodeType 需要名稱。

範例

下列範例會建立新的專案，並將它插入 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( "<book genre='novel' ISBN='1-861001-57-5'><title>Pride And Prejudice</title></book>" );
   
   //Create a new node and add it to the document.
   XmlNode^ elem = doc->CreateNode( XmlNodeType::Element, "price", nullptr );
   elem->InnerText = "19.95";
   doc->DocumentElement->AppendChild( elem );
   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("<book genre='novel' ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "</book>");

    //Create a new node and add it to the document.
    XmlNode elem = doc.CreateNode(XmlNodeType.Element, "price", null);
    elem.InnerText = "19.95";
    doc.DocumentElement.AppendChild(elem);

    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("<book genre='novel' ISBN='1-861001-57-5'>" & _
                    "<title>Pride And Prejudice</title>" & _
                    "</book>")
        
        'Create a new node and add it to the document.
        Dim elem As XmlNode = doc.CreateNode(XmlNodeType.Element, "price", Nothing)
        elem.InnerText = "19.95"
        doc.DocumentElement.AppendChild(elem)
        
        Console.WriteLine("Display the modified XML...")
        doc.Save(Console.Out)
    End Sub
End Class

備註

雖然這個方法會在檔的內容中建立新的物件，但它不會自動將新物件新增至檔樹狀結構。若要新增物件，您必須明確呼叫其中一個節點插入方法。

下表顯示根據 W3C 可延伸標記語言 (XML) 1.0 建議，在另一個 NodeType[column] 內允許哪些 NodeType[row]。

	文件	DocumentType	XmlDeclaration	項目	屬性	Text	CDATA	標記	EntityReference
`Document`	否	否	否	否	否	否	否	否	否
`DocumentType`	是	否	否	否	否	否	否	否	否
`XmlDeclaration`	是*	否	否	否	否	否	否	否	否
`Element`	是	否	否	是	否	否	否	否	是的***
`Attribute`	否	否	否	是的****	否	否	否	否	否
`Text`	否	否	否	是	是	否	否	否	是
`CDATA`	否	否	否	是	否	否	否	否	是的***
`Markup**`	是	否	否	是	否	否	否	否	否
`EntityReference`	否	否	否	是	是	否	否	否	是

* XmlDeclaration 節點必須是檔節點的第一個子節點。

** 標記包含 ProcessingInstruction 和 Comment 節點。

只有在 EntityReference 節點不是 Attribute 節點的子節點時，EntityReference 節點才允許元素和 CDATA 節點。

屬性不是元素節點的子系。屬性包含在屬於 Element 節點的屬性集合內。

此方法是檔物件模型 (DOM) Microsoft延伸模組。

適用於

CreateNode(XmlNodeType, String, String, String)

Source:: XmlDocument.cs

Source:: XmlDocument.cs

Source:: XmlDocument.cs

建立具有指定之 XmlNodeType、Prefix、Name 和 NamespaceURI 的 XmlNode。

public:
 virtual System::Xml::XmlNode ^ CreateNode(System::Xml::XmlNodeType type, System::String ^ prefix, System::String ^ name, System::String ^ namespaceURI);

public virtual System.Xml.XmlNode CreateNode (System.Xml.XmlNodeType type, string prefix, string name, string namespaceURI);

public virtual System.Xml.XmlNode CreateNode (System.Xml.XmlNodeType type, string? prefix, string name, string? namespaceURI);

abstract member CreateNode : System.Xml.XmlNodeType * string * string * string -> System.Xml.XmlNode
override this.CreateNode : System.Xml.XmlNodeType * string * string * string -> System.Xml.XmlNode

Public Overridable Function CreateNode (type As XmlNodeType, prefix As String, name As String, namespaceURI As String) As XmlNode

參數

type: XmlNodeType

新節點的 XmlNodeType。

prefix: String

新節點的前置詞。

name: String

新節點的區域名稱。

namespaceURI: String

新節點的命名空間 URI。

傳回

XmlNode

新的 XmlNode。

例外狀況

ArgumentException

未提供名稱且 XmlNodeType 需要名稱。

範例

下列範例會將新元素新增至檔。

#using <System.Xml.dll>

using namespace System;
using namespace System::Xml;
int main()
{
   XmlDocument^ doc = gcnew XmlDocument;
   doc->LoadXml( "<book>  <title>Oberon's Legacy</title>  <price>5.95</price></book>" );
   
   // Create a new element node.
   XmlNode^ newElem;
   newElem = doc->CreateNode( XmlNodeType::Element, "g" , "ISBN" , "https://global.ISBN/list" );
   newElem->InnerText = "1-861001-57-5";
    
   // Add the new element to the document
   XmlElement^ root = doc->DocumentElement;
   root->AppendChild( newElem );
    
   // Display the modified XML document
   Console::WriteLine( doc->OuterXml );
    
    // Output:
    // <book><title>Oberon's Legacy</title><price>5.95</price><g:ISBN xmlns:g="https://global.ISBN/list">1-861001-57-5</g:ISBN></book>
}

using System;
using System.Xml;

public class Sample {

  public static void Main() {

        // Create a new document containing information about a book
        XmlDocument doc = new XmlDocument();
        doc.LoadXml("<book>" +
                    "  <title>Oberon's Legacy</title>" +
                    "  <price>5.95</price>" +
                    "</book>");

        // Create a new element node for the ISBN of the book
        // It is possible to supply a prefix for this node, and specify a qualified namespace.
        XmlNode newElem;
        newElem = doc.CreateNode(XmlNodeType.Element, "g", "ISBN", "https://global.ISBN/list");
        newElem.InnerText = "1-861001-57-5";

        // Add the new element to the document
        XmlElement root = doc.DocumentElement;
        root.AppendChild(newElem);

        // Display the modified XML document
        Console.WriteLine(doc.OuterXml);

        //Output:
        // <book><title>Oberon's Legacy</title><price>5.95</price><g:ISBN xmlns:g="https://global.ISBN/list">1-861001-57-5</g:ISBN></book>
   }
 }

Imports System.Xml

public class Sample 

  public shared sub Main() 

        Dim doc as XmlDocument = new XmlDocument()
        doc.LoadXml("<book>" & _
                    "  <title>Oberon's Legacy</title>" & _
                    "  <price>5.95</price>" & _
                       "</book>") 
 
        ' Create a new element node.
        ' It is possible to supply a prefix for this node, and specify a qualified namespace
        Dim newElem as XmlNode
        newElem = doc.CreateNode(XmlNodeType.Element,"g", "ISBN","https://global.ISBN/list")
        newElem.InnerText = "1-861001-57-5"
     
        ' Add the new element to the document
        Dim root as XmlElement = doc.DocumentElement
        root.AppendChild(newElem)
     
        ' Display the modified XML document
        Console.WriteLine(doc.OuterXml)
        
        ' Output:
        ' <book><title>Oberon's Legacy</title><price>5.95</price><g:ISBN xmlns:g="https://global.ISBN/list">1-861001-57-5</g:ISBN></book>
   end sub
end class

備註

雖然這個方法會在檔的內容中建立新的物件，但它不會自動將新物件新增至檔樹狀結構。若要新增物件，您必須明確呼叫其中一個節點插入方法。

下表顯示根據 W3C 可延伸標記語言 (XML) 1.0 建議，在另一個 NodeType[column] 內允許哪些 NodeType[row]。

	文件	DocumentType	XmlDeclaration	項目	屬性	Text	CDATA	標記	EntityReference
`Document`	否	否	否	否	否	否	否	否	否
`DocumentType`	是	否	否	否	否	否	否	否	否
`XmlDeclaration`	是*	否	否	否	否	否	否	否	否
`Element`	是	否	否	是	否	否	否	否	是的***
`Attribute`	否	否	否	是的****	否	否	否	否	否
`Text`	否	否	否	是	是	否	否	否	是
`CDATA`	否	否	否	是	否	否	否	否	是的***
`Markup**`	是	否	否	是	否	否	否	否	否
`EntityReference`	否	否	否	是	是	否	否	否	是

* XmlDeclaration 節點必須是 Document 節點的第一個子系。

** 標記包含 ProcessingInstruction 和 Comment 節點。

只有在 EntityReference 節點不是 Attribute 節點的子節點時，EntityReference 節點才允許元素和 CDATA 節點。

屬性不是元素節點的子系。屬性包含在屬於元素節點的屬性集合內。

這個方法是檔物件模型 (DOM) Microsoft延伸模組。

適用於

XmlDocument.CreateNode 方法

定義

多載

CreateNode(String, String, String)

參數

傳回

例外狀況

範例

備註

適用於

CreateNode(XmlNodeType, String, String)

參數

傳回

例外狀況

範例

備註

適用於

CreateNode(XmlNodeType, String, String, String)

參數

傳回

例外狀況

範例

備註

適用於

意見反應

其他資源