XmlDocument.CreateElement Método

Referencia

Definición

Espacio de nombres:: System.Xml

Ensamblados:: System.Xml.dll, System.Xml.XmlDocument.dll

Ensamblado:: System.Xml.ReaderWriter.dll

Ensamblado:: System.Xml.XmlDocument.dll

Ensamblado:: System.Xml.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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

XmlElement

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

XmlElement

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"/>

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

XmlElement

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"/>

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

XmlDocument.CreateElement Método

Definición

Sobrecargas

CreateElement(String)

Parámetros

Devoluciones

Ejemplos

Comentarios

Se aplica a

CreateElement(String, String)

Parámetros

Devoluciones

Comentarios

Se aplica a

CreateElement(String, String, String)

Parámetros

Devoluciones

Ejemplos

Comentarios

Se aplica a

Comentarios

Recursos adicionales