XmlDocument.CreateElement Metode

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Membuat sebuah XmlElement.

Overload

Nama	Deskripsi
CreateElement(String)	Membuat elemen dengan nama yang ditentukan.
CreateElement(String, String)	XmlElement Membuat dengan nama yang memenuhi syarat dan NamespaceURI.
CreateElement(String, String, String)	Membuat elemen dengan yang ditentukan Prefix, , LocalNamedan NamespaceURI.

CreateElement(String)

Sumber:

XmlDocument.cs

Membuat elemen dengan nama yang ditentukan.

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

Parameter

name

String

Nama elemen yang memenuhi syarat. Jika nama berisi titik dua maka Prefix properti mencerminkan bagian dari nama yang mendahului titik dua dan LocalName properti mencerminkan bagian dari nama setelah titik dua. Nama yang memenuhi syarat tidak dapat menyertakan awalan 'xmlns'.

Mengembalikan

XmlElement

Yang baru XmlElement.

Contoh

Contoh berikut membuat elemen baru dan menambahkannya ke dokumen.

using System;
using System.Xml;

public class Sample
{
  public static void CreateTextNodeExample()
  {
    // Create the XmlDocument.
    XmlDocument doc = new();
    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);
  }
}

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

Contoh menghasilkan output berikut:

Display the modified XML...
<?xml version="1.0" encoding="utf-8"?>
<book genre="novel" ISBN="1-861001-57-5">
  <title>Pride And Prejudice</title>
  <price>19.95</price>
</book>

Keterangan

Perhatikan bahwa instans XmlElement yang dikembalikan mengimplementasikan antarmuka, sehingga atribut default akan dibuat langsung pada objek yang dikembalikan.

Meskipun metode ini membuat objek baru dalam konteks dokumen, metode ini tidak secara otomatis menambahkan objek baru ke pohon dokumen. Untuk menambahkan objek baru, Anda harus secara eksplisit memanggil salah satu metode sisipan simpul.

Menurut rekomendasi W3C Extensible Markup Language (XML) 1.0, node Elemen diizinkan dalam node Dokumen dan Elemen, dan dalam simpul EntityReference ketika node EntityReference bukan anak dari node Atribut.

CreateElement(String, String)

Sumber:

XmlDocument.cs

XmlElement Membuat dengan nama yang memenuhi syarat dan NamespaceURI.

public:
 System::Xml::XmlElement ^ CreateElement(System::String ^ qualifiedName, System::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

Parameter

qualifiedName

String

Nama elemen yang memenuhi syarat. Jika nama berisi titik dua maka Prefix properti akan mencerminkan bagian dari nama yang mendahului titik dua dan LocalName properti akan mencerminkan bagian dari nama setelah titik dua. Nama yang memenuhi syarat tidak dapat menyertakan awalan 'xmlns'.

namespaceURI

String

URI namespace elemen.

Mengembalikan

XmlElement

Yang baru XmlElement.

Keterangan

Kode C# berikut:

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

... menghasilkan elemen yang setara dengan XML berikut.

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

Meskipun metode ini membuat objek baru dalam konteks dokumen, metode ini tidak secara otomatis menambahkan objek baru ke pohon dokumen. Untuk menambahkan objek baru, Anda harus secara eksplisit memanggil salah satu metode sisipan simpul.

Menurut rekomendasi W3C Extensible Markup Language (XML) 1.0, node Elemen diizinkan dalam node Dokumen dan Elemen, dan dalam simpul EntityReference ketika node EntityReference bukan anak dari node Atribut.

CreateElement(String, String, String)

Sumber:

XmlDocument.cs

Membuat elemen dengan yang ditentukan Prefix, , LocalNamedan 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);

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

Parameter

prefix

String

Awalan elemen baru (jika ada). String.Empty dan null setara.

localName

String

Nama lokal elemen baru.

namespaceURI

String

URI namespace dari elemen baru (jika ada). String.Empty dan null setara.

Mengembalikan

XmlElement

Yang baru XmlElement.

Contoh

Contoh berikut menambahkan elemen baru ke dokumen XML yang sudah ada.

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

public class Sample1
{
  public static void CreateElementExample()
  {
    // Create the XmlDocument.
    XmlDocument doc = new();
    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

Keterangan

Kode C# berikut:

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

... membuat elemen yang setara dengan XML berikut:

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

Meskipun metode ini membuat objek baru dalam konteks dokumen, metode ini tidak secara otomatis menambahkan objek baru ke pohon dokumen. Untuk menambahkan objek baru, Anda harus secara eksplisit memanggil salah satu metode sisipan simpul.

Menurut rekomendasi W3C Extensible Markup Language (XML) 1.0, simpul Elemen diizinkan dalam simpul Dokumen dan Elemen, dan dalam simpul EntityReference ketika EntityReference berada di luar node Atribut.

Metode ini adalah ekstensi Microsoft ke Model Objek Dokumen (DOM).