XmlDocument.CreateElement Metódus

Definíció

Névtér:

System.Xml

Szerelvények:

netstandard.dll, System.Xml.ReaderWriter.dll

Létrehoz egy XmlElement.

Túlterhelések

Name	Description
CreateElement(String)	Létrehoz egy elemet a megadott névvel.
CreateElement(String, String)	Létrehoz egy XmlElement minősített nevet és NamespaceURI.
CreateElement(String, String, String)	Létrehoz egy elemet a megadott Prefix, LocalNameés NamespaceURI.

CreateElement(String)

Forrás:

XmlDocument.cs

Létrehoz egy elemet a megadott névvel.

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

Paraméterek

name

String

Az elem minősített neve. Ha a név kettőspontot tartalmaz, akkor a Prefix tulajdonság a kettőspont előtti névrészt tükrözi, a LocalName tulajdonság pedig a kettőspont utáni névrészt tükrözi. A minősített név nem tartalmazhat "xmlns" előtagot.

Válaszok

XmlElement

Az új XmlElement.

Példák

Az alábbi példa létrehoz egy új elemet, és hozzáadja a dokumentumhoz.

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

A példa a következő kimenetet hozza létre:

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>

Megjegyzések

Vegye figyelembe, hogy a visszaadott példány implementálja az XmlElement interfészt, így az alapértelmezett attribútumok közvetlenül a visszaadott objektumon jönnek létre.

Bár ez a metódus a dokumentum kontextusában hozza létre az új objektumot, nem adja hozzá automatikusan az új objektumot a dokumentumfához. Az új objektum hozzáadásához explicit módon meg kell hívnia a csomópont beszúrási módszereinek egyikét.

A W3C bővíthető korrektúranyelv (XML) 1.0-s javaslata szerint az elemcsomópontok engedélyezettek a dokumentum- és elemcsomópontokban, valamint az EntityReference csomópontokban, ha az EntityReference csomópont nem attribútumcsomópont gyermeke.

CreateElement(String, String)

Forrás:

XmlDocument.cs

Létrehoz egy XmlElement minősített nevet és 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

Paraméterek

qualifiedName

String

Az elem minősített neve. Ha a név kettőspontot tartalmaz, akkor a Prefix tulajdonság a kettőspontot megelőző névrészt fogja tükrözni, a LocalName tulajdonság pedig a kettőspont utáni névrészt fogja tükrözni. A minősített név nem tartalmazhat "xmlns" előtagot.

namespaceURI

String

Az elem névterének URI-ja.

Válaszok

XmlElement

Az új XmlElement.

Megjegyzések

A következő C#-kód:

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

... az alábbi XML-nek megfelelő elemet eredményez.

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

Bár ez a metódus a dokumentum kontextusában hozza létre az új objektumot, nem adja hozzá automatikusan az új objektumot a dokumentumfához. Az új objektum hozzáadásához explicit módon meg kell hívnia a csomópont beszúrási módszereinek egyikét.

A W3C bővíthető korrektúranyelv (XML) 1.0-s javaslata szerint az elemcsomópontok engedélyezettek a dokumentum- és elemcsomópontokban, valamint az EntityReference csomópontokban, ha az EntityReference csomópont nem attribútumcsomópont gyermeke.

CreateElement(String, String, String)

Forrás:

XmlDocument.cs

Létrehoz egy elemet a megadott Prefix, LocalNameés 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

Paraméterek

prefix

String

Az új elem előtagja (ha van ilyen). String.Empty és null egyenértékű.

localName

String

Az új elem helyi neve.

namespaceURI

String

Az új elem névterének URI-ja (ha van ilyen). String.Empty és null egyenértékű.

Válaszok

XmlElement

Az új XmlElement.

Példák

Az alábbi példa egy új elemet ad hozzá a meglévő XML-dokumentumhoz.

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

Megjegyzések

A következő C#-kód:

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

... a következő XML-nek megfelelő elemet hoz létre:

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

Bár ez a metódus a dokumentum kontextusában hozza létre az új objektumot, nem adja hozzá automatikusan az új objektumot a dokumentumfához. Az új objektum hozzáadásához explicit módon meg kell hívnia a csomópont beszúrási módszereinek egyikét.

A W3C bővíthető korrektúranyelv (XML) 1.0-s javaslata szerint az elemcsomópontok engedélyezettek a dokumentum- és elemcsomópontokban, valamint az EntityReference csomópontokban, ha az EntityReference attribútumcsomóponton kívül esik.

Ez a metódus a Dokumentumobjektum-modell (DOM) Microsoft bővítménye.