XmlDocument.CreateElement Methode

Definition

Erstellt ein XmlElement.

Überlädt

CreateElement(String)

Erstellt ein Element mit dem angegebenen Namen.

CreateElement(String, String)

Erstellt ein XmlElement mit dem qualifizierten Namen und dem NamespaceURI.

CreateElement(String, String, String)

Erstellt ein Element mit dem angegebenen Prefix, LocalName und der NamespaceURI.

CreateElement(String)

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 vor dem Doppelpunkt stehenden Teil des Namens und die LocalName-Eigenschaft den hinter dem Doppelpunkt stehenden Teil wieder. Der qualifizierte Name darf nicht das Präfix "xmlns" enthalten.

Gibt zurück

Die neue XmlElement.

Beispiele

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

#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

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 Knoteneinfügungsmethoden aufrufen.

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

Gilt für:

CreateElement(String, String)

Erstellt ein XmlElement mit dem qualifizierten Namen und dem NamespaceURI.

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

Parameter

qualifiedName
String

Der qualifizierte Name des Elements. Wenn der Name einen Doppelpunkt enthält, gibt die Prefix-Eigenschaft den vor dem Doppelpunkt stehenden Teil des Namens und die LocalName-Eigenschaft den hinter dem Doppelpunkt stehenden Teil wieder. Der qualifizierte Name darf nicht das Präfix "xmlns" enthalten.

namespaceURI
String

Der Namespace-URI des Elements.

Gibt zurück

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-Text 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 Knoteneinfügungsmethoden aufrufen.

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

Gilt für:

CreateElement(String, String, String)

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

Parameter

prefix
String

Das Präfix des neuen Elements (sofern vorhanden). „String.Empty“ und null sind äquivalent.

localName
String

Der lokale Name des neuen Elements.

namespaceURI
String

Der Namespace-URI des neuen Elements (sofern vorhanden). „String.Empty“ und null sind äquivalent.

Gibt zurück

Die neue XmlElement.

Beispiele

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

#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

Hinweise

Der folgende C#-Code

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

erstellt ein Element, das dem folgenden XML-Text 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 Knoteneinfügungsmethoden aufrufen.

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

Diese Methode ist eine Microsoft Erweiterung des Document Object Model (DOM).

Gilt für: