XmlDocument.CreateElement 方法

參考

定義

命名空間:: System.Xml

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

組件:: System.Xml.ReaderWriter.dll

組件:: System.Xml.XmlDocument.dll

組件:: System.Xml.dll

組件:: netstandard.dll

重要

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

建立 XmlElement。

多載

CreateElement(String)	建立具有指定名稱的項目。
CreateElement(String, String)	建立具有限定名稱和 NamespaceURI 的 XmlElement。
CreateElement(String, String, String)	建立具有指定之 Prefix、LocalName 和 NamespaceURI 的元素。

CreateElement(String)

來源:: XmlDocument.cs

來源:: XmlDocument.cs

來源:: XmlDocument.cs

建立具有指定名稱的項目。

public:
 System::Xml::XmlElement ^ CreateElement(System::String ^ name);

public System.Xml.XmlElement CreateElement (string name);

member this.CreateElement : string -> System.Xml.XmlElement

Public Function CreateElement (name As String) As XmlElement

參數

name: String

項目的限定名稱。如果名稱包含冒號，Prefix 屬性會反映冒號之前的名稱部分，而 LocalName 屬性會反映冒號之後的名稱部分。限定名稱不能包含 'xmlns' 前置詞。

傳回

XmlElement

新的 XmlElement。

範例

下列範例會建立新的元素，並將其新增至檔。

#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.
   //The text node is the content of the price element.
   XmlElement^ elem = doc->CreateElement( "price" );
   XmlText^ text = doc->CreateTextNode( "19.95" );
   doc->DocumentElement->AppendChild( elem );
   doc->DocumentElement->LastChild->AppendChild( text );
   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.
    //The text node is the content of the price element.
    XmlElement elem = doc.CreateElement("price");
    XmlText text = doc.CreateTextNode("19.95");
    doc.DocumentElement.AppendChild(elem);
    doc.DocumentElement.LastChild.AppendChild(text);

    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.
        'The text node is the content of the price element.
        Dim elem As XmlElement = doc.CreateElement("price")
        Dim text As XmlText = doc.CreateTextNode("19.95")
        doc.DocumentElement.AppendChild(elem)
        doc.DocumentElement.LastChild.AppendChild(text)
        
        Console.WriteLine("Display the modified XML...")
        doc.Save(Console.Out)
    End Sub
End Class

備註

請注意，傳回的實例會 XmlElement 實作介面，因此預設屬性會直接在傳回的物件上建立。

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

根據 W3C Extensible Markup Language (XML) 1.0 建議，在 Document 和 Element 節點內允許元素節點，以及 EntityReference 節點中當 EntityReference 節點不是 Attribute 節點的子節點時。

適用於

CreateElement(String, String)

來源:: XmlDocument.cs

來源:: XmlDocument.cs

來源:: XmlDocument.cs

建立具有限定名稱和 NamespaceURI 的 XmlElement。

public:
 System::Xml::XmlElement ^ CreateElement(System::String ^ qualifiedName, System::String ^ namespaceURI);

public System.Xml.XmlElement CreateElement (string qualifiedName, string namespaceURI);

public System.Xml.XmlElement CreateElement (string qualifiedName, string? namespaceURI);

member this.CreateElement : string * string -> System.Xml.XmlElement

Public Function CreateElement (qualifiedName As String, namespaceURI As String) As XmlElement

參數

qualifiedName: String

項目的限定名稱。如果名稱包含冒號，Prefix 屬性會反映冒號前面的名稱部分，而 LocalName 屬性會反映冒號後面的名稱部分。限定名稱不能包含 'xmlns' 前置詞。

namespaceURI: String

項目的命名空間 URI。

傳回

XmlElement

新的 XmlElement。

備註

下列 C# 程式碼

XmlElement elem;
elem=doc.CreateElement("xy:item", "urn:abc");

會產生相當於下列 XML 文字的專案。

<xy:item
       xmlns:xy="urn:abc"/>

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

適用於

CreateElement(String, String, String)

來源:: XmlDocument.cs

來源:: XmlDocument.cs

來源:: XmlDocument.cs

建立具有指定之 Prefix、LocalName 和 NamespaceURI 的元素。

public:
 virtual System::Xml::XmlElement ^ CreateElement(System::String ^ prefix, System::String ^ localName, System::String ^ namespaceURI);

public virtual System.Xml.XmlElement CreateElement (string prefix, string localName, string namespaceURI);

public virtual System.Xml.XmlElement CreateElement (string? prefix, string localName, string? namespaceURI);

abstract member CreateElement : string * string * string -> System.Xml.XmlElement
override this.CreateElement : string * string * string -> System.Xml.XmlElement

Public Overridable Function CreateElement (prefix As String, localName As String, namespaceURI As String) As XmlElement

參數

prefix: String

新項目的前置詞 (如有此項)。 String.Empty 與 null 相等。

localName: String

新項目的本機名稱。

namespaceURI: String

新項目的命名空間 URI (如有此項)。 String.Empty 與 null 相等。

傳回

XmlElement

新的 XmlElement。

範例

下列範例會將新的專案加入至現有的 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;
   String^ xmlData = "<book xmlns:bk='urn:samples'></book>";
   doc->Load( gcnew StringReader( xmlData ) );
   
   // Create a new element and add it to the document.
   XmlElement^ elem = doc->CreateElement( "bk", "genre", "urn:samples" );
   elem->InnerText = "fantasy";
   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();
    string xmlData = "<book xmlns:bk='urn:samples'></book>";

    doc.Load(new StringReader(xmlData));

    // Create a new element and add it to the document.
    XmlElement elem = doc.CreateElement("bk", "genre", "urn:samples");
    elem.InnerText = "fantasy";
    doc.DocumentElement.AppendChild(elem);

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

Imports System.IO
Imports System.Xml

public class Sample 

  public shared sub Main() 

    ' Create the XmlDocument.
    Dim doc as XmlDocument = new XmlDocument()
    Dim xmlData as string = "<book xmlns:bk='urn:samples'></book>"

    doc.Load(new StringReader(xmlData))

    ' Create a new element and add it to the document.
    Dim elem as XmlElement = doc.CreateElement("bk", "genre", "urn:samples")
    elem.InnerText = "fantasy"
    doc.DocumentElement.AppendChild(elem)

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

  end sub
end class

備註

下列 C# 程式碼

XmlElement elem;
elem=doc.CreateElement("xy", "item", "urn:abc");

會建立相當於下列 XML 文字的專案：

<xy:item xmlns:xy="urn:abc"/>

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

根據 W3C Extensible Markup Language (XML) 1.0 建議，在 Document 和 Element 節點內允許元素節點，以及在 EntityReference 節點中當 EntityReference 位於 Attribute 節點外部時。

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

適用於

共用方式為

XmlDocument.CreateElement 方法

定義

多載

CreateElement(String)

參數

傳回

範例

備註

適用於

CreateElement(String, String)

參數

傳回

備註

適用於

CreateElement(String, String, String)

參數

傳回

範例

備註

適用於

其他資源