XmlDocument.CreateElement Methode

Definition

Namespace:

System.Xml

Assemblys:

netstandard.dll, System.Xml.ReaderWriter.dll

Erstellt ein XmlElement.

Überlädt

Name	Beschreibung
CreateElement(String)	Erstellt ein Element mit dem angegebenen Namen.
CreateElement(String, String)	Erstellt einen XmlElement mit dem qualifizierten Namen und NamespaceURI.
CreateElement(String, String, String)	Erstellt ein Element mit dem angegebenen Prefix, LocalName, und NamespaceURI.

CreateElement(String)

Quelle:

XmlDocument.cs

Erstellt ein Element mit dem angegebenen Namen.

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

Der qualifizierte Name des Elements. Wenn der Name einen Doppelpunkt enthält, gibt die Prefix Eigenschaft den Teil des Namens vor dem Doppelpunkt wieder, und die LocalName Eigenschaft gibt den Teil des Namens nach dem Doppelpunkt wieder. Der qualifizierte Name darf kein Präfix von 'xmlns' enthalten.

Gibt zurück

XmlElement

Die neue XmlElement.

Beispiele

Im folgenden Beispiel wird ein neues Element erstellt und dem Dokument hinzugefügt.

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

Das Beispiel erzeugt die folgende Ausgabe:

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>

Hinweise

Beachten Sie, dass die zurückgegebene Instanz die XmlElement Schnittstelle implementiert, sodass Standardattribute direkt für das zurückgegebene Objekt erstellt werden.

Obwohl diese Methode das neue Objekt im Kontext des Dokuments erstellt, wird das neue Objekt nicht automatisch der Dokumentstruktur hinzugefügt. Um das neue Objekt hinzuzufügen, müssen Sie explizit eine der Methoden zum Einfügen von Knoten aufrufen.

Gemäß der Empfehlung von W3C Extensible Markup Language (XML) 1.0 sind Elementknoten innerhalb von Dokument- und Elementknoten zulässig, und in EntityReference-Knoten, wenn der EntityReference-Knoten kein untergeordnetes Element eines Attributknotens ist.

CreateElement(String, String)

Quelle:

XmlDocument.cs

Erstellt einen XmlElement mit dem qualifizierten Namen und 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

Der qualifizierte Name des Elements. Wenn der Name einen Doppelpunkt enthält, gibt die Prefix Eigenschaft den Teil des Namens vor dem Doppelpunkt wieder, und die LocalName Eigenschaft gibt den Teil des Namens nach dem Doppelpunkt wieder. Der qualifizierte Name darf kein Präfix von 'xmlns' enthalten.

namespaceURI

String

Der Namespace-URI des Elements.

Gibt zurück

XmlElement

Die neue XmlElement.

Hinweise

Der folgende C#-Code:

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

... führt zu einem Element, das dem folgenden XML entspricht.

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

Obwohl diese Methode das neue Objekt im Kontext des Dokuments erstellt, wird das neue Objekt nicht automatisch der Dokumentstruktur hinzugefügt. Um das neue Objekt hinzuzufügen, müssen Sie explizit eine der Methoden zum Einfügen von Knoten aufrufen.

Gemäß der Empfehlung von W3C Extensible Markup Language (XML) 1.0 sind Elementknoten innerhalb von Dokument- und Elementknoten zulässig, und in EntityReference-Knoten, wenn der EntityReference-Knoten kein untergeordnetes Element eines Attributknotens ist.

CreateElement(String, String, String)

Quelle:

XmlDocument.cs

Erstellt ein Element mit dem angegebenen Prefix, LocalName, und 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

Das Präfix des neuen Elements (falls vorhanden). String.Empty und null sind gleichwertig.

localName

String

Der lokale Name des neuen Elements.

namespaceURI

String

Der Namespace-URI des neuen Elements (falls vorhanden). String.Empty und null sind gleichwertig.

Gibt zurück

XmlElement

Die neue XmlElement.

Beispiele

Im folgenden Beispiel wird dem vorhandenen XML-Dokument ein neues Element hinzugefügt.

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

Hinweise

Der folgende C#-Code:

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

... erstellt ein Element, das dem folgenden XML-Code entspricht:

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

Obwohl diese Methode das neue Objekt im Kontext des Dokuments erstellt, wird das neue Objekt nicht automatisch der Dokumentstruktur hinzugefügt. Um das neue Objekt hinzuzufügen, müssen Sie explizit eine der Methoden zum Einfügen von Knoten aufrufen.

Gemäß der Empfehlung für W3C Extensible Markup Language (XML) 1.0 sind Elementknoten innerhalb von Dokument- und Elementknoten zulässig, und in EntityReference-Knoten, wenn sich die EntityReference außerhalb eines Attributknotens befindet.

Diese Methode ist eine Microsoft Erweiterung für das Document Object Model (DOM).