Compartir a través de


XmlDocument.CreateElement Método

Definición

Crea una interfaz XmlElement.

Sobrecargas

CreateElement(String)

Crea un elemento con el nombre especificado.

CreateElement(String, String)

Crea un XmlElement con el nombre completo y el NamespaceURI.

CreateElement(String, String, String)

Crea un elemento con los Prefix, LocalName y NamespaceURI especificados.

CreateElement(String)

Source:
XmlDocument.cs
Source:
XmlDocument.cs
Source:
XmlDocument.cs

Crea un elemento con el nombre especificado.

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

Parámetros

name
String

Nombre completo del elemento. Si el nombre contiene un carácter de dos puntos, la propiedad Prefix refleja la parte del nombre que va delante del carácter de dos puntos y la propiedad LocalName refleja la parte que va detrás. El nombre completo no puede incluir un prefijo de 'xmlns'.

Devoluciones

Nuevo objeto XmlElement.

Ejemplos

En el ejemplo siguiente se crea un nuevo elemento y se agrega al documento.

#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

Comentarios

Tenga en cuenta que la instancia devuelta implementa la XmlElement interfaz, por lo que los atributos predeterminados se crearían directamente en el objeto devuelto.

Aunque este método crea el nuevo objeto en el contexto del documento, no agrega automáticamente el nuevo objeto al árbol de documentos. Para agregar el nuevo objeto, debe llamar explícitamente a uno de los métodos de inserción de nodo.

Según la recomendación W3C Extensible Markup Language (XML) 1.0, se permiten nodos de elemento dentro de los nodos Document y Element, y en los nodos EntityReference cuando el nodo EntityReference no es un elemento secundario de un nodo Attribute.

Se aplica a

CreateElement(String, String)

Source:
XmlDocument.cs
Source:
XmlDocument.cs
Source:
XmlDocument.cs

Crea un XmlElement con el nombre completo y el 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

Parámetros

qualifiedName
String

Nombre completo del elemento. Si el nombre contiene un carácter de dos puntos, la propiedad Prefix reflejará la parte del nombre que va delante del carácter de dos puntos y la propiedad LocalName reflejará la parte que va detrás. El nombre completo no puede incluir un prefijo de 'xmlns'.

namespaceURI
String

Identificador URI de espacio de nombres del elemento.

Devoluciones

Nuevo objeto XmlElement.

Comentarios

Código de C# siguiente

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

da como resultado un elemento equivalente al siguiente texto XML.

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

Aunque este método crea el nuevo objeto en el contexto del documento, no agrega automáticamente el nuevo objeto al árbol de documentos. Para agregar el nuevo objeto, debe llamar explícitamente a uno de los métodos de inserción de nodo.

Según la recomendación W3C Extensible Markup Language (XML) 1.0, se permiten nodos de elemento dentro de los nodos Document y Element, y en los nodos EntityReference cuando el nodo EntityReference no es un elemento secundario de un nodo Attribute.

Se aplica a

CreateElement(String, String, String)

Source:
XmlDocument.cs
Source:
XmlDocument.cs
Source:
XmlDocument.cs

Crea un elemento con los Prefix, LocalName y NamespaceURI especificados.

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

Parámetros

prefix
String

Prefijo del nuevo elemento, si lo tiene. String.Empty y null son equivalentes.

localName
String

Nombre local del nuevo elemento.

namespaceURI
String

Identificador URI de espacio de nombres del nuevo elemento, si lo tiene. String.Empty y null son equivalentes.

Devoluciones

Nuevo objeto XmlElement.

Ejemplos

En el ejemplo siguiente se agrega un nuevo elemento al documento XML existente.

#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

Comentarios

Código de C# siguiente

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

crea un elemento equivalente al texto XML siguiente:

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

Aunque este método crea el nuevo objeto en el contexto del documento, no agrega automáticamente el nuevo objeto al árbol de documentos. Para agregar el nuevo objeto, debe llamar explícitamente a uno de los métodos de inserción de nodo.

Según la recomendación W3C Extensible Markup Language (XML) 1.0, se permiten nodos de elemento dentro de los nodos Document y Element, y en los nodos EntityReference cuando EntityReference está fuera de un nodo Attribute.

Este método es una extensión Microsoft al Modelo de objetos de documento (DOM).

Se aplica a