XmlDocument.CreateElement Metod

Definition

Namnområde:: System.Xml

Sammansättningar:: System.Xml.dll, System.Xml.XmlDocument.dll

Sammansättningar:: netstandard.dll, System.Xml.ReaderWriter.dll

Sammansättning:: System.Xml.XmlDocument.dll

Sammansättning:: System.Xml.ReaderWriter.dll

Sammansättning:: System.Xml.dll

Sammansättning:: netstandard.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Skapar en XmlElement.

Överlagringar

Name	Description
CreateElement(String)	Skapar ett element med det angivna namnet.
CreateElement(String, String)	Skapar ett XmlElement med det kvalificerade namnet och NamespaceURI.
CreateElement(String, String, String)	Skapar ett element med angivet Prefix, LocalNameoch NamespaceURI.

CreateElement(String)

Källa:: XmlDocument.cs

Källa:: XmlDocument.cs

Källa:: XmlDocument.cs

Källa:: XmlDocument.cs

Källa:: XmlDocument.cs

Skapar ett element med det angivna namnet.

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

Parametrar

name: String

Elementets kvalificerade namn. Om namnet innehåller ett kolon Prefix återspeglar egenskapen den del av namnet som föregår kolonet LocalName och egenskapen återspeglar delen av namnet efter kolonet. Det kvalificerade namnet kan inte innehålla prefixet "xmlns".

Returer

XmlElement

Den nya XmlElement.

Exempel

I följande exempel skapas ett nytt element och det läggs till i dokumentet.

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

Exemplet genererar följande utdata:

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>

Kommentarer

Observera att den returnerade instansen XmlElement implementerar gränssnittet, så standardattribut skapas direkt på det returnerade objektet.

Även om den här metoden skapar det nya objektet i dokumentets kontext, lägger det inte automatiskt till det nya objektet i dokumentträdet. Om du vill lägga till det nya objektet måste du uttryckligen anropa någon av nodinfogningsmetoderna.

Enligt rekommendationen W3C Extensible Markup Language (XML) 1.0 tillåts elementnoder i dokument- och elementnoder och i EntityReference-noder när EntityReference-noden inte är underordnad en attributnod.

Gäller för

CreateElement(String, String)

Källa:: XmlDocument.cs

Källa:: XmlDocument.cs

Källa:: XmlDocument.cs

Källa:: XmlDocument.cs

Källa:: XmlDocument.cs

Skapar ett XmlElement med det kvalificerade namnet och 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

Parametrar

qualifiedName: String

Elementets kvalificerade namn. Om namnet innehåller ett kolon Prefix återspeglar egenskapen den del av namnet som föregår kolonet LocalName och egenskapen återspeglar den del av namnet efter kolonet. Det kvalificerade namnet kan inte innehålla prefixet "xmlns".

namespaceURI: String

Elementets namnområdes-URI.

Returer

XmlElement

Den nya XmlElement.

Kommentarer

Följande C#-kod:

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

... resulterar i ett element som motsvarar följande XML.

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

Gäller för

CreateElement(String, String, String)

Källa:: XmlDocument.cs

Källa:: XmlDocument.cs

Källa:: XmlDocument.cs

Källa:: XmlDocument.cs

Källa:: XmlDocument.cs

Skapar ett element med angivet Prefix, LocalNameoch 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

Parametrar

prefix: String

Prefixet för det nya elementet (om det finns något). String.Empty och null är likvärdiga.

localName: String

Det nya elementets lokala namn.

namespaceURI: String

Namnområdes-URI:n för det nya elementet (om det finns något). String.Empty och null är likvärdiga.

Returer

XmlElement

Den nya XmlElement.

Exempel

I följande exempel läggs ett nytt element till i det befintliga XML-dokumentet.

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

Kommentarer

Följande C#-kod:

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

... skapar ett element som motsvarar följande XML:

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

Enligt rekommendationen W3C Extensible Markup Language (XML) 1.0 tillåts elementnoder i dokument- och elementnoder och i EntityReference-noder när EntityReference ligger utanför en attributnod.

Den här metoden är ett Microsoft-tillägg till dokumentobjektmodellen (DOM).

Gäller för

Feedback

Var den här sidan till hjälp?