XmlDocument.CreateElement Yöntem

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Xml.ReaderWriter.dll

bir XmlElementoluşturur.

Aşırı Yüklemeler

Name	Description
CreateElement(String)	Belirtilen ada sahip bir öğe oluşturur.
CreateElement(String, String)	ve XmlElementnitelenmiş adıyla bir NamespaceURI oluşturur.
CreateElement(String, String, String)	Belirtilen Prefix, LocalNameve NamespaceURIile bir öğe oluşturur.

CreateElement(String)

Kaynak:

XmlDocument.cs

Belirtilen ada sahip bir öğe oluşturur.

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

Parametreler

name

String

Öğesinin nitelenmiş adı. Ad iki nokta üst üste Prefix içeriyorsa, özellik adın iki nokta üst üsteden önceki bölümünü yansıtır ve LocalName özellik de adın iki nokta üst üsteden sonraki bölümünü yansıtır. Nitelenmiş ad 'xmlns' ön ekini içeremez.

Döndürülenler

XmlElement

Yeni XmlElement.

Örnekler

Aşağıdaki örnek yeni bir öğe oluşturur ve belgeye ekler.

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

Örnek aşağıdaki çıkışı oluşturur:

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>

Açıklamalar

Döndürülen örneğin arabirimi uyguladığını XmlElement , dolayısıyla varsayılan özniteliklerin doğrudan döndürülen nesnede oluşturulacağını unutmayın.

Bu yöntem yeni nesneyi belge bağlamında oluştursa da, yeni nesneyi belge ağacına otomatik olarak eklemez. Yeni nesneyi eklemek için düğüm ekleme yöntemlerinden birini açıkça çağırmanız gerekir.

W3C Genişletilebilir Biçimlendirme Dili (XML) 1.0 önerisine göre, EntityReference düğümü bir Öznitelik düğümünün alt öğesi olmadığında, Öğe düğümlerine Belge ve Öğe düğümleri içinde ve EntityReference düğümlerinde izin verilir.

CreateElement(String, String)

Kaynak:

XmlDocument.cs

ve XmlElementnitelenmiş adıyla bir NamespaceURI oluşturur.

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

Parametreler

qualifiedName

String

Öğesinin nitelenmiş adı. Ad iki nokta üst üste Prefix içeriyorsa, özellik adın iki nokta üst üsteden önceki bölümünü yansıtır ve LocalName özellik de adın iki nokta üst üsteden sonraki bölümünü yansıtır. Nitelenmiş ad 'xmlns' ön ekini içeremez.

namespaceURI

String

öğesinin ad alanı URI'si.

Döndürülenler

XmlElement

Yeni XmlElement.

Açıklamalar

Aşağıdaki C# kodu:

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

... sonuç olarak aşağıdaki XML'ye eşdeğer bir öğe elde edin.

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

Bu yöntem yeni nesneyi belge bağlamında oluştursa da, yeni nesneyi belge ağacına otomatik olarak eklemez. Yeni nesneyi eklemek için düğüm ekleme yöntemlerinden birini açıkça çağırmanız gerekir.

W3C Genişletilebilir Biçimlendirme Dili (XML) 1.0 önerisine göre, EntityReference düğümü bir Öznitelik düğümünün alt öğesi olmadığında, Öğe düğümlerine Belge ve Öğe düğümleri içinde ve EntityReference düğümlerinde izin verilir.

CreateElement(String, String, String)

Kaynak:

XmlDocument.cs

Belirtilen Prefix, LocalNameve NamespaceURIile bir öğe oluşturur.

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

Parametreler

prefix

String

Yeni öğenin öneki (varsa). String.Empty ve null eşdeğerdir.

localName

String

Yeni öğenin yerel adı.

namespaceURI

String

Yeni öğenin ad alanı URI'si (varsa). String.Empty ve null eşdeğerdir.

Döndürülenler

XmlElement

Yeni XmlElement.

Örnekler

Aşağıdaki örnek, var olan XML belgesine yeni bir öğe ekler.

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

Açıklamalar

Aşağıdaki C# kodu:

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

... aşağıdaki XML'ye eşdeğer bir öğe oluşturur:

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

Bu yöntem yeni nesneyi belge bağlamında oluştursa da, yeni nesneyi belge ağacına otomatik olarak eklemez. Yeni nesneyi eklemek için düğüm ekleme yöntemlerinden birini açıkça çağırmanız gerekir.

W3C Genişletilebilir Biçimlendirme Dili (XML) 1.0 önerisine göre, EntityReference bir Öznitelik düğümü dışında olduğunda, Öğe düğümlerine Document ve Element düğümleri içinde ve EntityReference düğümlerinde izin verilir.

Bu yöntem, Belge Nesne Modeli'nin (DOM) Microsoft bir uzantısıdır.