XmlDocument.CreateElement Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

Vytvoří XmlElement.

Přetížení

Name	Description
CreateElement(String)	Vytvoří prvek se zadaným názvem.
CreateElement(String, String)	Vytvoří s kvalifikovaným XmlElement názvem a NamespaceURI.
CreateElement(String, String, String)	Vytvoří prvek se zadaným Prefixznakem , LocalNamea NamespaceURI.

CreateElement(String)

Zdroj:

XmlDocument.cs

Vytvoří prvek se zadaným názvem.

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

Parametry

name

String

Kvalifikovaný název elementu. Pokud název obsahuje dvojtečku, Prefix vlastnost odráží část názvu předcházející dvojtečku a LocalName vlastnost odráží část názvu za dvojtečku. Kvalifikovaný název nemůže obsahovat předponu xmlns.

Návraty

XmlElement

XmlElementNový .

Příklady

Následující příklad vytvoří nový prvek a přidá ho do dokumentu.

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

Příklad vytvoří následující výstup:

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>

Poznámky

Všimněte si, že vrácená instance implementuje XmlElement rozhraní, takže výchozí atributy by byly vytvořeny přímo na vrácený objekt.

I když tato metoda vytvoří nový objekt v kontextu dokumentu, nepřidá automaticky nový objekt do stromu dokumentu. Chcete-li přidat nový objekt, musíte explicitně volat jednu z metod vložení uzlu.

Podle doporučení W3C Extensible Markup Language (XML) 1.0 jsou uzly elementů povoleny v uzlech Document a Element a v uzlech EntityReference, pokud uzel EntityReference není podřízeným uzlem atributu.

CreateElement(String, String)

Zdroj:

XmlDocument.cs

Vytvoří s kvalifikovaným XmlElement názvem a 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

Parametry

qualifiedName

String

Kvalifikovaný název elementu. Pokud název obsahuje dvojtečku, Prefix vlastnost bude odrážet část názvu předcházející dvojtečku a LocalName vlastnost bude odrážet část názvu za dvojtečku. Kvalifikovaný název nemůže obsahovat předponu xmlns.

namespaceURI

String

Identifikátor URI oboru názvů elementu.

Návraty

XmlElement

XmlElementNový .

Poznámky

Následující kód jazyka C#:

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

... výsledkem je element, který je ekvivalentní následujícímu XML.

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

I když tato metoda vytvoří nový objekt v kontextu dokumentu, nepřidá automaticky nový objekt do stromu dokumentu. Chcete-li přidat nový objekt, musíte explicitně volat jednu z metod vložení uzlu.

Podle doporučení W3C Extensible Markup Language (XML) 1.0 jsou uzly elementů povoleny v uzlech Document a Element a v uzlech EntityReference, pokud uzel EntityReference není podřízeným uzlem atributu.

CreateElement(String, String, String)

Zdroj:

XmlDocument.cs

Vytvoří prvek se zadaným Prefixznakem , LocalNamea 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

Parametry

prefix

String

Předpona nového prvku (pokud existuje). String.Empty a null jsou ekvivalentní.

localName

String

Místní název nového prvku.

namespaceURI

String

Identifikátor URI oboru názvů nového elementu (pokud existuje). String.Empty a null jsou ekvivalentní.

Návraty

XmlElement

XmlElementNový .

Příklady

Následující příklad přidá nový prvek do existujícího dokumentu XML.

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

Poznámky

Následující kód jazyka C#:

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

... vytvoří prvek ekvivalentní následujícímu XML:

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

I když tato metoda vytvoří nový objekt v kontextu dokumentu, nepřidá automaticky nový objekt do stromu dokumentu. Chcete-li přidat nový objekt, musíte explicitně volat jednu z metod vložení uzlu.

Podle doporučení W3C Extensible Markup Language (XML) 1.0 jsou uzly elementů povoleny v uzlech Document a Element a v uzlech EntityReference, pokud EntityReference je mimo uzel atributu.

Tato metoda je rozšíření Microsoft modelu DOM (Document Object Model).