XmlDocument.CreateElement Метод

Определение

Пространство имен:

System.Xml

Сборки:

netstandard.dll, System.Xml.ReaderWriter.dll

Создает объект XmlElement.

Перегрузки

Имя	Описание
CreateElement(String)	Создает элемент с указанным именем.
CreateElement(String, String)	XmlElement Создает имя с полным именем и NamespaceURI.
CreateElement(String, String, String)	Создает элемент с указанным Prefix, LocalNameи NamespaceURI.

CreateElement(String)

Исходный код:

XmlDocument.cs

Создает элемент с указанным именем.

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

Параметры

name

String

Полное имя элемента. Если имя содержит двоеточие, Prefix то свойство отражает часть имени перед двоеточием, а LocalName свойство отражает часть имени после двоеточия. Полное имя не может содержать префикс xmlns.

Возвращаемое значение

XmlElement

Новый XmlElement.

Примеры

В следующем примере создается новый элемент и добавляется в документ.

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

В примере создаются следующие выходные данные:

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>

Комментарии

Обратите внимание, что возвращенный экземпляр реализует XmlElement интерфейс, поэтому атрибуты по умолчанию будут созданы непосредственно в возвращаемом объекте.

Хотя этот метод создает новый объект в контексте документа, он не автоматически добавляет новый объект в дерево документов. Чтобы добавить новый объект, необходимо явно вызвать один из методов вставки узла.

В соответствии с рекомендацией W3C Расширяемый язык разметки (XML) 1.0 узлы элементов разрешены в узлах Document и Element, а также в узлах EntityReference, если узел EntityReference не является дочерним элементом узла атрибута.

CreateElement(String, String)

Исходный код:

XmlDocument.cs

XmlElement Создает имя с полным именем и 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

Параметры

qualifiedName

String

Полное имя элемента. Если имя содержит двоеточие, Prefix то свойство будет отражать часть имени перед двоеточием, а LocalName свойство будет отражать часть имени после двоеточия. Полное имя не может содержать префикс xmlns.

namespaceURI

String

URI пространства имен элемента.

Возвращаемое значение

XmlElement

Новый XmlElement.

Комментарии

Следующий код C#:

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

... результаты в элементе, эквивалентном следующему XML.

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

Хотя этот метод создает новый объект в контексте документа, он не автоматически добавляет новый объект в дерево документов. Чтобы добавить новый объект, необходимо явно вызвать один из методов вставки узла.

В соответствии с рекомендацией W3C Расширяемый язык разметки (XML) 1.0 узлы элементов разрешены в узлах Document и Element, а также в узлах EntityReference, если узел EntityReference не является дочерним элементом узла атрибута.

CreateElement(String, String, String)

Исходный код:

XmlDocument.cs

Создает элемент с указанным Prefix, LocalNameи 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

Параметры

prefix

String

Префикс нового элемента (если таковой есть). String.Empty и null эквивалентны.

localName

String

Локальное имя нового элемента.

namespaceURI

String

URI пространства имен нового элемента (если таковой имеется). String.Empty и null эквивалентны.

Возвращаемое значение

XmlElement

Новый XmlElement.

Примеры

В следующем примере в существующий 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

Комментарии

Следующий код C#:

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

... создает элемент, эквивалентный следующему XML:

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

Хотя этот метод создает новый объект в контексте документа, он не автоматически добавляет новый объект в дерево документов. Чтобы добавить новый объект, необходимо явно вызвать один из методов вставки узла.

Согласно рекомендации W3C Расширяемый язык разметки (XML) 1.0, узлы элементов разрешены в узлах Document и Element, а также в узлах EntityReference, когда EntityReference находится за пределами узла атрибута.

Этот метод представляет собой расширение Microsoft объектной модели документа (DOM).