XmlDocument.CreateElement Metoda

Reference

Definice

Obor názvů:: System.Xml

Sestavení:: System.Xml.dll, System.Xml.XmlDocument.dll

Sestavení:: System.Xml.ReaderWriter.dll

Sestavení:: System.Xml.XmlDocument.dll

Sestavení:: System.Xml.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Vytvoří .XmlElement

Přetížení

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

CreateElement(String)

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

Nový XmlElement.

Příklady

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

#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

Poznámky

Všimněte si, že vrácená instance implementuje XmlElement rozhraní, takže výchozí atributy by se vytvořily 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.

Platí pro

CreateElement(String, String)

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

Parametry

qualifiedName: String

Kvalifikovaný název elementu. Pokud název obsahuje dvojtečku, Prefix bude vlastnost 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

Nový XmlElement.

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 textu XML.

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

Platí pro

CreateElement(String, String, String)

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

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

Nový XmlElement.

Příklady

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

#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

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 textu XML:

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

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ím Microsoftu na model DOM (Document Object Model).

Platí pro

Sdílet prostřednictvím

XmlDocument.CreateElement Metoda

Definice

Přetížení

CreateElement(String)

Parametry

Návraty

Příklady

Poznámky

Platí pro

CreateElement(String, String)

Parametry

Návraty

Poznámky

Platí pro

CreateElement(String, String, String)

Parametry

Návraty

Příklady

Poznámky

Platí pro

Další materiály