XmlDocument.CreateElement Methode

Definitie

Naamruimte:: System.Xml

Assembly's:: System.Xml.dll, System.Xml.XmlDocument.dll

Assembly's:: netstandard.dll, System.Xml.ReaderWriter.dll

Assembly:: System.Xml.XmlDocument.dll

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

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

Bron:: XmlDocument.cs

Bron:: XmlDocument.cs

Bron:: XmlDocument.cs

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.

Van toepassing op

CreateElement(String, String)

Bron:: XmlDocument.cs

Bron:: XmlDocument.cs

Bron:: XmlDocument.cs

Bron:: XmlDocument.cs

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);

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"/>

Van toepassing op

CreateElement(String, String, String)

Bron:: XmlDocument.cs

Bron:: XmlDocument.cs

Bron:: XmlDocument.cs

Bron:: XmlDocument.cs

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);

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"/>

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).

Van toepassing op

Feedback

Is deze pagina nuttig?