XmlDocument.CreateElement Метод

Определение

Создает XmlElement.Creates an XmlElement.

Перегрузки

CreateElement(String)

Создает элемент с указанным именем.Creates an element with the specified name.

CreateElement(String, String)

Создает XmlElement с помощью полного имени и NamespaceURI.Creates an XmlElement with the qualified name and NamespaceURI.

CreateElement(String, String, String)

Создает элемент с помощью указанных Prefix, LocalName и NamespaceURI.Creates an element with the specified Prefix, LocalName, and NamespaceURI.

CreateElement(String)

Создает элемент с указанным именем.Creates an element with the specified name.

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

Полное имя элемента.The qualified name of the element. Если имя содержит двоеточие, свойство Prefix отражает часть имени, предшествующую ему, а свойство LocalName — ту часть, которая следует за двоеточием.If the name contains a colon then the Prefix property reflects the part of the name preceding the colon and the LocalName property reflects the part of the name after the colon. Полное имя не может содержать префикс "xmlns".The qualified name cannot include a prefix of 'xmlns'.

Возвраты

Новый объект XmlElement.The new XmlElement.

Примеры

В следующем примере создается новый элемент и добавляется в документ.The following example creates a new element and adds it to the document.

#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

Комментарии

Обратите внимание, что возвращаемый XmlElement экземпляр реализует интерфейс, поэтому атрибуты по умолчанию будут создаваться непосредственно на возвращенном объекте.Note that the instance returned implements the XmlElement interface, so default attributes would be created directly on the returned object.

Несмотря на то, что этот метод создает новый объект в контексте документа, он не добавляет новый объект автоматически в дерево документов.Although this method creates the new object in the context of the document, it does not automatically add the new object to the document tree. Чтобы добавить новый объект, необходимо явным образом вызвать один из методов вставки узла.To add the new object, you must explicitly call one of the node insert methods.

В соответствии с рекомендацией консорциума W3C язык XML (XML) 1,0узлы элементов разрешены в узлах документов и элементов, а также в узлах EntityReference, если узел EntityReference не является дочерним по отношению к узлу атрибута.According to the W3C Extensible Markup Language (XML) 1.0 recommendation, Element nodes are allowed within Document and Element nodes, and in EntityReference nodes when the EntityReference node is not a child of an Attribute node.

CreateElement(String, String)

Создает XmlElement с помощью полного имени и NamespaceURI.Creates an XmlElement with the qualified name and 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

Полное имя элемента.The qualified name of the element. Если имя содержит двоеточие, свойство Prefix отражает часть имени, предшествующую ему, а свойство LocalName — ту часть, которая следует за двоеточием.If the name contains a colon then the Prefix property will reflect the part of the name preceding the colon and the LocalName property will reflect the part of the name after the colon. Полное имя не может содержать префикс "xmlns".The qualified name cannot include a prefix of 'xmlns'.

namespaceURI
String

Универсальный код ресурса (URI) пространства имен элемента.The namespace URI of the element.

Возвраты

Новый объект XmlElement.The new XmlElement.

Комментарии

Следующий C# кодThe following C# code

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

приводит к элементу, эквивалентному следующему XML-тексту.results in an element that is equivalent to the following XML text.

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

Несмотря на то, что этот метод создает новый объект в контексте документа, он не добавляет новый объект автоматически в дерево документов.Although this method creates the new object in the context of the document, it does not automatically add the new object to the document tree. Чтобы добавить новый объект, необходимо явным образом вызвать один из методов вставки узла.To add the new object, you must explicitly call one of the node insert methods.

В соответствии с рекомендацией консорциума W3C язык XML (XML) 1,0узлы элементов разрешены в узлах документов и элементов, а также в узлах EntityReference, если узел EntityReference не является дочерним по отношению к узлу атрибута.According to the W3C Extensible Markup Language (XML) 1.0 recommendation, Element nodes are allowed within Document and Element nodes, and in EntityReference nodes when the EntityReference node is not a child of an Attribute node.

CreateElement(String, String, String)

Создает элемент с помощью указанных Prefix, LocalName и NamespaceURI.Creates an element with the specified Prefix, LocalName, and 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

Префикс нового элемента (если имеется).The prefix of the new element (if any). String.Empty равно значению null .String.Empty and null are equivalent.

localName
String

Локальное имя нового элемента.The local name of the new element.

namespaceURI
String

URI пространства имен нового элемента (если имеется).The namespace URI of the new element (if any). String.Empty равно значению null.String.Empty and null are equivalent.

Возвраты

Новый объект XmlElement.The new XmlElement.

Примеры

В следующем примере в существующий XML-документ добавляется новый элемент.The following example adds a new element to the existing XML document.

#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

Комментарии

Следующий C# кодThe following C# code

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

создает элемент, эквивалентный следующему XML-тексту:creates an element equivalent to the following XML text:

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

Несмотря на то, что этот метод создает новый объект в контексте документа, он не добавляет новый объект автоматически в дерево документов.Although this method creates the new object in the context of the document, it does not automatically add the new object to the document tree. Чтобы добавить новый объект, необходимо явным образом вызвать один из методов вставки узла.To add the new object, you must explicitly call one of the node insert methods.

В соответствии с рекомендацией консорциума W3C язык XML (XML) 1,0узлы элементов разрешены в узлах документов и элементов, а также в узлах EntityReference, если EntityReference находится за пределами узла атрибута.According to the W3C Extensible Markup Language (XML) 1.0 recommendation, Element nodes are allowed within Document and Element nodes, and in EntityReference nodes when the EntityReference is outside an Attribute node.

Этот метод является расширением Майкрософт для модель DOM (DOM).This method is a Microsoft extension to the Document Object Model (DOM).

Применяется к