XmlDocument.CreateElement Methode

Definitie

Naamruimte:

System.Xml

Assembly's:

netstandard.dll, System.Xml.ReaderWriter.dll

Hiermee maakt u een XmlElement.

Overloads

Name	Description
CreateElement(String)	Hiermee maakt u een element met de opgegeven naam.
CreateElement(String, String)	Hiermee maakt u een XmlElement met de gekwalificeerde naam en NamespaceURI.
CreateElement(String, String, String)	Hiermee maakt u een element met de opgegeven Prefix, LocalNameen NamespaceURI.

CreateElement(String)

Bron:

XmlDocument.cs

Hiermee maakt u een element met de opgegeven naam.

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

Parameters

name

String

De gekwalificeerde naam van het element. Als de naam een dubbele punt bevat, weerspiegelt de Prefix eigenschap het deel van de naam voorafgaand aan de dubbele punt en de LocalName eigenschap weerspiegelt het deel van de naam na de dubbele punt. De gekwalificeerde naam mag geen voorvoegsel 'xmlns' bevatten.

Retouren

XmlElement

Het nieuwe XmlElement.

Voorbeelden

In het volgende voorbeeld wordt een nieuw element gemaakt en toegevoegd aan het document.

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

Het voorbeeld produceert de volgende uitvoer:

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>

Opmerkingen

Houd er rekening mee dat het geretourneerde exemplaar de XmlElement interface implementeert, zodat standaardkenmerken rechtstreeks op het geretourneerde object worden gemaakt.

Hoewel met deze methode het nieuwe object wordt gemaakt in de context van het document, wordt het nieuwe object niet automatisch toegevoegd aan de documentstructuur. Als u het nieuwe object wilt toevoegen, moet u expliciet een van de methoden voor het invoegen van knooppunten aanroepen.

Volgens de aanbeveling W3C Extensible Markup Language (XML) 1.0 zijn elementknooppunten toegestaan binnen document- en elementknooppunten en in EntityReference-knooppunten wanneer het knooppunt EntityReference geen onderliggend element van een kenmerkknooppunt is.

CreateElement(String, String)

Bron:

XmlDocument.cs

Hiermee maakt u een XmlElement met de gekwalificeerde naam en 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

Parameters

qualifiedName

String

De gekwalificeerde naam van het element. Als de naam een dubbele punt bevat, geeft de Prefix eigenschap het deel van de naam vóór de dubbele punt weer en geeft de LocalName eigenschap het deel van de naam na de dubbele punt weer. De gekwalificeerde naam mag geen voorvoegsel 'xmlns' bevatten.

namespaceURI

String

De naamruimte-URI van het element.

Retouren

XmlElement

Het nieuwe XmlElement.

Opmerkingen

De volgende C#-code:

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

... resulteert in een element dat gelijk is aan de volgende XML.

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

Hoewel met deze methode het nieuwe object wordt gemaakt in de context van het document, wordt het nieuwe object niet automatisch toegevoegd aan de documentstructuur. Als u het nieuwe object wilt toevoegen, moet u expliciet een van de methoden voor het invoegen van knooppunten aanroepen.

Volgens de aanbeveling W3C Extensible Markup Language (XML) 1.0 zijn elementknooppunten toegestaan binnen document- en elementknooppunten en in EntityReference-knooppunten wanneer het knooppunt EntityReference geen onderliggend element van een kenmerkknooppunt is.

CreateElement(String, String, String)

Bron:

XmlDocument.cs

Hiermee maakt u een element met de opgegeven Prefix, LocalNameen 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

Parameters

prefix

String

Het voorvoegsel van het nieuwe element (indien van toepassing). String.Empty en null zijn gelijkwaardig.

localName

String

De lokale naam van het nieuwe element.

namespaceURI

String

De naamruimte-URI van het nieuwe element (indien van toepassing). String.Empty en null zijn gelijkwaardig.

Retouren

XmlElement

Het nieuwe XmlElement.

Voorbeelden

In het volgende voorbeeld wordt een nieuw element toegevoegd aan het bestaande XML-document.

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

Opmerkingen

De volgende C#-code:

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

... maakt een element dat gelijk is aan de volgende XML:

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

Hoewel met deze methode het nieuwe object wordt gemaakt in de context van het document, wordt het nieuwe object niet automatisch toegevoegd aan de documentstructuur. Als u het nieuwe object wilt toevoegen, moet u expliciet een van de methoden voor het invoegen van knooppunten aanroepen.

Volgens de aanbeveling W3C Extensible Markup Language (XML) 1.0 zijn elementknooppunten toegestaan binnen document- en elementknooppunten en in EntityReference-knooppunten wanneer de EntityReference zich buiten een kenmerkknooppunt bevindt.

Deze methode is een Microsoft extensie voor het Document Object Model (DOM).