XmlDocument.CreateElement XmlDocument.CreateElement XmlDocument.CreateElement XmlDocument.CreateElement Method

Definition

Erstellt ein XmlElement.Creates an XmlElement.

Überlädt

CreateElement(String) CreateElement(String) CreateElement(String) CreateElement(String)

Erstellt ein Element mit dem angegebenen Namen.Creates an element with the specified name.

CreateElement(String, String) CreateElement(String, String) CreateElement(String, String) CreateElement(String, String)

Erstellt ein XmlElement mit dem qualifizierten Namen und dem NamespaceURI.Creates an XmlElement with the qualified name and NamespaceURI.

CreateElement(String, String, String) CreateElement(String, String, String) CreateElement(String, String, String) CreateElement(String, String, String)

Erstellt ein Element mit dem angegebenen Prefix, LocalName und der NamespaceURI.Creates an element with the specified Prefix, LocalName, and NamespaceURI.

CreateElement(String) CreateElement(String) CreateElement(String) CreateElement(String)

Erstellt ein Element mit dem angegebenen Namen.Creates an element with the specified name.

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 String String String

Der qualifizierte Name des Elements.The qualified name of the element. 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.If the name contains a colon then the Prefix property reflects the part of the name preceding the colon and the LocalName property reflects the part of the name after the colon. Der qualifizierte Name darf nicht das Präfix "xmlns" enthalten.The qualified name cannot include a prefix of 'xmlns'.

Gibt zurück

Die neue XmlElement.The new XmlElement.

Beispiele

Im folgenden Beispiel wird ein neues-Element erstellt und dem Dokument hinzugefügt.The following example creates a new element and adds it to the document.

#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 XmlElement -Instanz die-Schnittstelle implementiert, sodass Standard Attribute direkt für das zurückgegebene-Objekt erstellt werden.Note that the instance returned implements the XmlElement interface, so default attributes would be created directly on the returned object.

Obwohl diese Methode das neue-Objekt im Kontext des Dokuments erstellt, wird das neue-Objekt nicht automatisch der Dokumentstruktur hinzugefügt.Although this method creates the new object in the context of the document, it does not automatically add the new object to the document tree. Um das neue-Objekt hinzuzufügen, müssen Sie explizit eine der Knoten Einfügemethoden aufzurufen.To add the new object, you must explicitly call one of the node insert methods.

Gemäß der Empfehlung W3C- Extensible Markup Language (XML) 1,0sind Element Knoten innerhalb von Dokument-und Element Knoten sowie in EntityReference-Knoten zulässig, wenn der EntityReference-Knoten kein untergeordnetes Element eines Attribut Knotens ist.According to the W3C Extensible Markup Language (XML) 1.0 recommendation, Element nodes are allowed within Document and Element nodes, and in EntityReference nodes when the EntityReference node is not a child of an Attribute node.

CreateElement(String, String) CreateElement(String, String) CreateElement(String, String) CreateElement(String, String)

Erstellt ein XmlElement mit dem qualifizierten Namen und dem NamespaceURI.Creates an XmlElement with the qualified name and 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 String String String

Der qualifizierte Name des Elements.The qualified name of the element. 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.If the name contains a colon then the Prefix property will reflect the part of the name preceding the colon and the LocalName property will reflect the part of the name after the colon. Der qualifizierte Name darf nicht das Präfix "xmlns" enthalten.The qualified name cannot include a prefix of 'xmlns'.

namespaceURI
String String String String

Der Namespace-URI des Elements.The namespace URI of the element.

Gibt zurück

Die neue XmlElement.The new XmlElement.

Hinweise

Der folgende C# CodeThe following C# code

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

führt zu einem Element, das dem folgenden XML-Text entspricht.results in an element that is equivalent to the following XML text.

<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.Although this method creates the new object in the context of the document, it does not automatically add the new object to the document tree. Um das neue-Objekt hinzuzufügen, müssen Sie explizit eine der Knoten Einfügemethoden aufzurufen.To add the new object, you must explicitly call one of the node insert methods.

Gemäß der Empfehlung W3C- Extensible Markup Language (XML) 1,0sind Element Knoten innerhalb von Dokument-und Element Knoten sowie in EntityReference-Knoten zulässig, wenn der EntityReference-Knoten kein untergeordnetes Element eines Attribut Knotens ist.According to the W3C Extensible Markup Language (XML) 1.0 recommendation, Element nodes are allowed within Document and Element nodes, and in EntityReference nodes when the EntityReference node is not a child of an Attribute node.

CreateElement(String, String, String) CreateElement(String, String, String) CreateElement(String, String, String) CreateElement(String, String, String)

Erstellt ein Element mit dem angegebenen Prefix, LocalName und der NamespaceURI.Creates an element with the specified Prefix, LocalName, and 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 String String String

Das Präfix des neuen Elements (sofern vorhanden).The prefix of the new element (if any). „String.Empty“ und null sind äquivalent.String.Empty and null are equivalent.

localName
String String String String

Der lokale Name des neuen Elements.The local name of the new element.

namespaceURI
String String String String

Der Namespace-URI des neuen Elements (sofern vorhanden).The namespace URI of the new element (if any). „String.Empty“ und null sind äquivalent.String.Empty and null are equivalent.

Gibt zurück

Beispiele

Im folgenden Beispiel wird dem vorhandenen XML-Dokument ein neues-Element hinzugefügt.The following example adds a new element to the existing XML document.

#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# CodeThe following C# code

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

erstellt ein-Element, das dem folgenden XML-Text entspricht:creates an element equivalent to the following XML text:

<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.Although this method creates the new object in the context of the document, it does not automatically add the new object to the document tree. Um das neue-Objekt hinzuzufügen, müssen Sie explizit eine der Knoten Einfügemethoden aufzurufen.To add the new object, you must explicitly call one of the node insert methods.

Gemäß der Empfehlung W3C- Extensible Markup Language (XML) 1,0sind Element Knoten innerhalb von Dokument-und Element Knoten sowie in EntityReference-Knoten zulässig, wenn der EntityReference außerhalb eines Attribut Knotens liegt.According to the W3C Extensible Markup Language (XML) 1.0 recommendation, Element nodes are allowed within Document and Element nodes, and in EntityReference nodes when the EntityReference is outside an Attribute node.

Diese Methode ist eine Microsoft-Erweiterung für die Dokumentobjektmodell (DOM).This method is a Microsoft extension to the Document Object Model (DOM).

Gilt für: