XmlDocument.CreateNode 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 XmlNode.

Sobrecargas

CreateNode(String, String, String)	Crea un XmlNode con el tipo de nodo especificado, Name y NamespaceURI.
CreateNode(XmlNodeType, String, String)	Crea un XmlNode con los XmlNodeType, Name y NamespaceURI especificados.
CreateNode(XmlNodeType, String, String, String)	Crea un XmlNode con los XmlNodeType, Prefix, Name y NamespaceURI especificados.

CreateNode(String, String, String)

Source:: XmlDocument.cs

Source:: XmlDocument.cs

Source:: XmlDocument.cs

Crea un XmlNode con el tipo de nodo especificado, Name y NamespaceURI.

public:
 virtual System::Xml::XmlNode ^ CreateNode(System::String ^ nodeTypeString, System::String ^ name, System::String ^ namespaceURI);

public virtual System.Xml.XmlNode CreateNode (string nodeTypeString, string name, string namespaceURI);

public virtual System.Xml.XmlNode CreateNode (string nodeTypeString, string name, string? namespaceURI);

abstract member CreateNode : string * string * string -> System.Xml.XmlNode
override this.CreateNode : string * string * string -> System.Xml.XmlNode

Public Overridable Function CreateNode (nodeTypeString As String, name As String, namespaceURI As String) As XmlNode

Parámetros

nodeTypeString: String

Versión de cadena del XmlNodeType del nuevo nodo. Este parámetro debe ser uno de los valores de la tabla que figura más abajo.

name: String

Nombre completo del nuevo nodo. Si el nombre contiene un carácter de dos puntos, se analiza en los componentes Prefix y LocalName.

namespaceURI: String

Identificador URI de espacio de nombres del nuevo nodo.

Devoluciones

XmlNode

Nuevo objeto XmlNode.

Excepciones

ArgumentException

No se ha proporcionado el nombre y XmlNodeType requiere un nombre; o nodeTypeString no es una de las cadenas enumeradas a continuación.

Ejemplos

En el ejemplo siguiente se crea un nuevo elemento y se inserta en el documento.

#using <System.Xml.dll>

using namespace System;
using namespace System::Xml;
int main()
{
   XmlDocument^ doc = gcnew XmlDocument;
   doc->LoadXml( "<book>  <title>Oberon's Legacy</title>  <price>5.95</price></book>" );
   
   // Create a new element node.
   XmlNode^ newElem = doc->CreateNode( "element", "pages", "" );
   newElem->InnerText = "290";
   Console::WriteLine( "Add the new element to the document..." );
   XmlElement^ root = doc->DocumentElement;
   root->AppendChild( newElem );
   Console::WriteLine( "Display the modified XML document..." );
   Console::WriteLine( doc->OuterXml );
}

using System;
using System.Xml;

public class Sample {

  public static void Main() {

       XmlDocument doc = new XmlDocument();
       doc.LoadXml("<book>" +
                   "  <title>Oberon's Legacy</title>" +
                   "  <price>5.95</price>" +
                   "</book>");

       // Create a new element node.
       XmlNode newElem = doc.CreateNode("element", "pages", "");
       newElem.InnerText = "290";

       Console.WriteLine("Add the new element to the document...");
       XmlElement root = doc.DocumentElement;
       root.AppendChild(newElem);

       Console.WriteLine("Display the modified XML document...");
       Console.WriteLine(doc.OuterXml);
   }
 }

Imports System.Xml

public class Sample 

  public shared sub Main() 

       Dim doc as XmlDocument = new XmlDocument()
       doc.LoadXml("<book>" & _
                   "  <title>Oberon's Legacy</title>" & _
                   "  <price>5.95</price>" & _
                   "</book>") 
 
       ' Create a new element node.
       Dim newElem as XmlNode = doc.CreateNode("element", "pages", "")  
       newElem.InnerText = "290"
     
       Console.WriteLine("Add the new element to the document...")
       Dim root as XmlElement = doc.DocumentElement
       root.AppendChild(newElem)
     
       Console.WriteLine("Display the modified XML document...")
       Console.WriteLine(doc.OuterXml)
   end sub
end class

Comentarios

El nodeTypeString parámetro distingue mayúsculas de minúsculas y debe ser uno de los valores de la tabla siguiente.

nodeTypeString	Tipo XmlNode
atributo	Atributo
cdatasection	CDATA
comment	Comentario
documento	Documento
documentfragment	DocumentFragment
documenttype	DocumentType
elemento	Elemento
Entityreference	EntityReference
processinginstruction	ProcessingInstruction
significantwhitespace	SignificantWhitespace
texto	Texto
whitespace	Espacio en blanco

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.

En la tabla siguiente se muestra qué nodeType[row] se permite dentro de otra nodeType[column] según la recomendación W3C Extensible Markup Language (XML) 1.0.

	Documento	DocumentType	XmlDeclaration	Elemento	Atributo	Texto	CDATA	marcado	EntityReference
`Document`	no	no	no	no	no	no	no	no	no
`DocumentType`	sí	no	no	no	no	no	no	no	no
`XmlDeclaration`	sí*	no	no	no	no	no	no	no	no
`Element`	sí	no	no	sí	no	no	no	no	Sí***
`Attribute`	no	no	no	Sí****	no	no	no	no	no
`Text`	no	no	no	sí	sí	no	no	no	sí
`CDATA`	no	no	no	sí	no	no	no	no	Sí***
`Markup**`	sí	no	no	sí	no	no	no	no	no
`EntityReference`	no	no	no	sí	sí	no	no	no	sí

* El nodo XmlDeclaration debe ser el primer elemento secundario del nodo Document.

** El marcado incluye nodos ProcessingInstruction y Comment.

Los nodos Element y CDATA solo se permiten en los nodos EntityReference cuando el nodo EntityReference no es un elemento secundario de un nodo Attribute.

Los atributos no son secundarios de un nodo Element. Los atributos se encuentran dentro de una colección de atributos que pertenece a un nodo Element.

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

Se aplica a

CreateNode(XmlNodeType, String, String)

Source:: XmlDocument.cs

Source:: XmlDocument.cs

Source:: XmlDocument.cs

Crea un XmlNode con los XmlNodeType, Name y NamespaceURI especificados.

public:
 virtual System::Xml::XmlNode ^ CreateNode(System::Xml::XmlNodeType type, System::String ^ name, System::String ^ namespaceURI);

public virtual System.Xml.XmlNode CreateNode (System.Xml.XmlNodeType type, string name, string namespaceURI);

public virtual System.Xml.XmlNode CreateNode (System.Xml.XmlNodeType type, string name, string? namespaceURI);

abstract member CreateNode : System.Xml.XmlNodeType * string * string -> System.Xml.XmlNode
override this.CreateNode : System.Xml.XmlNodeType * string * string -> System.Xml.XmlNode

Public Overridable Function CreateNode (type As XmlNodeType, name As String, namespaceURI As String) As XmlNode

Parámetros

type: XmlNodeType

XmlNodeType del nuevo nodo.

name: String

Nombre completo del nuevo nodo. Si el nombre contiene un carácter de dos puntos, se analiza en los componentes Prefix y LocalName.

namespaceURI: String

Identificador URI de espacio de nombres del nuevo nodo.

Devoluciones

XmlNode

Nuevo objeto XmlNode.

Excepciones

ArgumentException

No se ha proporcionado el nombre y XmlNodeType requiere un nombre.

Ejemplos

En el ejemplo siguiente se crea un nuevo elemento y se inserta en un documento XML.

#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.
   XmlNode^ elem = doc->CreateNode( XmlNodeType::Element, "price", nullptr );
   elem->InnerText = "19.95";
   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();
    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.
    XmlNode elem = doc.CreateNode(XmlNodeType.Element, "price", null);
    elem.InnerText = "19.95";
    doc.DocumentElement.AppendChild(elem);

    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.
        Dim elem As XmlNode = doc.CreateNode(XmlNodeType.Element, "price", Nothing)
        elem.InnerText = "19.95"
        doc.DocumentElement.AppendChild(elem)
        
        Console.WriteLine("Display the modified XML...")
        doc.Save(Console.Out)
    End Sub
End Class

Comentarios

En la tabla siguiente se muestra lo que se permite NodeType[row] dentro de otro NodeType[column] según la recomendación W3C Extensible Markup Language (XML) 1.0.

	Documento	DocumentType	XmlDeclaration	Elemento	Atributo	Texto	CDATA	marcado	EntityReference
`Document`	no	no	no	no	no	no	no	no	no
`DocumentType`	sí	no	no	no	no	no	no	no	no
`XmlDeclaration`	sí*	no	no	no	no	no	no	no	no
`Element`	sí	no	no	sí	no	no	no	no	Sí***
`Attribute`	no	no	no	Sí****	no	no	no	no	no
`Text`	no	no	no	sí	sí	no	no	no	sí
`CDATA`	no	no	no	sí	no	no	no	no	Sí***
`Markup**`	sí	no	no	sí	no	no	no	no	no
`EntityReference`	no	no	no	sí	sí	no	no	no	sí

* El nodo XmlDeclaration debe ser el primer elemento secundario del nodo Document.

** El marcado incluye nodos ProcessingInstruction y Comment.

Los nodos Element y CDATA solo se permiten en los nodos EntityReference cuando el nodo EntityReference no es un elemento secundario de un nodo Attribute.

Los atributos no son secundarios de un nodo Element. Los atributos se encuentran dentro de una colección de atributos que pertenece a un nodo Element.

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

Se aplica a

CreateNode(XmlNodeType, String, String, String)

Source:: XmlDocument.cs

Source:: XmlDocument.cs

Source:: XmlDocument.cs

Crea un XmlNode con los XmlNodeType, Prefix, Name y NamespaceURI especificados.

public:
 virtual System::Xml::XmlNode ^ CreateNode(System::Xml::XmlNodeType type, System::String ^ prefix, System::String ^ name, System::String ^ namespaceURI);

public virtual System.Xml.XmlNode CreateNode (System.Xml.XmlNodeType type, string prefix, string name, string namespaceURI);

public virtual System.Xml.XmlNode CreateNode (System.Xml.XmlNodeType type, string? prefix, string name, string? namespaceURI);

abstract member CreateNode : System.Xml.XmlNodeType * string * string * string -> System.Xml.XmlNode
override this.CreateNode : System.Xml.XmlNodeType * string * string * string -> System.Xml.XmlNode

Public Overridable Function CreateNode (type As XmlNodeType, prefix As String, name As String, namespaceURI As String) As XmlNode

Parámetros

type: XmlNodeType

XmlNodeType del nuevo nodo.

prefix: String

Prefijo del nuevo nodo.

name: String

Nombre local del nuevo nodo.

namespaceURI: String

Identificador URI de espacio de nombres del nuevo nodo.

Devoluciones

XmlNode

Nuevo objeto XmlNode.

Excepciones

ArgumentException

No se ha proporcionado el nombre y XmlNodeType requiere un nombre.

Ejemplos

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

#using <System.Xml.dll>

using namespace System;
using namespace System::Xml;
int main()
{
   XmlDocument^ doc = gcnew XmlDocument;
   doc->LoadXml( "<book>  <title>Oberon's Legacy</title>  <price>5.95</price></book>" );
   
   // Create a new element node.
   XmlNode^ newElem;
   newElem = doc->CreateNode( XmlNodeType::Element, "g" , "ISBN" , "https://global.ISBN/list" );
   newElem->InnerText = "1-861001-57-5";
    
   // Add the new element to the document
   XmlElement^ root = doc->DocumentElement;
   root->AppendChild( newElem );
    
   // Display the modified XML document
   Console::WriteLine( doc->OuterXml );
    
    // Output:
    // <book><title>Oberon's Legacy</title><price>5.95</price><g:ISBN xmlns:g="https://global.ISBN/list">1-861001-57-5</g:ISBN></book>
}

using System;
using System.Xml;

public class Sample {

  public static void Main() {

        // Create a new document containing information about a book
        XmlDocument doc = new XmlDocument();
        doc.LoadXml("<book>" +
                    "  <title>Oberon's Legacy</title>" +
                    "  <price>5.95</price>" +
                    "</book>");

        // Create a new element node for the ISBN of the book
        // It is possible to supply a prefix for this node, and specify a qualified namespace.
        XmlNode newElem;
        newElem = doc.CreateNode(XmlNodeType.Element, "g", "ISBN", "https://global.ISBN/list");
        newElem.InnerText = "1-861001-57-5";

        // Add the new element to the document
        XmlElement root = doc.DocumentElement;
        root.AppendChild(newElem);

        // Display the modified XML document
        Console.WriteLine(doc.OuterXml);

        //Output:
        // <book><title>Oberon's Legacy</title><price>5.95</price><g:ISBN xmlns:g="https://global.ISBN/list">1-861001-57-5</g:ISBN></book>
   }
 }

Imports System.Xml

public class Sample 

  public shared sub Main() 

        Dim doc as XmlDocument = new XmlDocument()
        doc.LoadXml("<book>" & _
                    "  <title>Oberon's Legacy</title>" & _
                    "  <price>5.95</price>" & _
                       "</book>") 
 
        ' Create a new element node.
        ' It is possible to supply a prefix for this node, and specify a qualified namespace
        Dim newElem as XmlNode
        newElem = doc.CreateNode(XmlNodeType.Element,"g", "ISBN","https://global.ISBN/list")
        newElem.InnerText = "1-861001-57-5"
     
        ' Add the new element to the document
        Dim root as XmlElement = doc.DocumentElement
        root.AppendChild(newElem)
     
        ' Display the modified XML document
        Console.WriteLine(doc.OuterXml)
        
        ' Output:
        ' <book><title>Oberon's Legacy</title><price>5.95</price><g:ISBN xmlns:g="https://global.ISBN/list">1-861001-57-5</g:ISBN></book>
   end sub
end class

Comentarios

En la tabla siguiente se muestra lo que se permite NodeType[row] dentro de otro NodeType[column] según la recomendación W3C Extensible Markup Language (XML) 1.0.

	Documento	DocumentType	XmlDeclaration	Elemento	Atributo	Texto	CDATA	marcado	EntityReference
`Document`	no	no	no	no	no	no	no	no	no
`DocumentType`	sí	no	no	no	no	no	no	no	no
`XmlDeclaration`	sí*	no	no	no	no	no	no	no	no
`Element`	sí	no	no	sí	no	no	no	no	Sí***
`Attribute`	no	no	no	Sí****	no	no	no	no	no
`Text`	no	no	no	sí	sí	no	no	no	sí
`CDATA`	no	no	no	sí	no	no	no	no	Sí***
`Markup**`	sí	no	no	sí	no	no	no	no	no
`EntityReference`	no	no	no	sí	sí	no	no	no	sí

* El nodo XmlDeclaration debe ser el primer elemento secundario del nodo Document.

** El marcado incluye nodos ProcessingInstruction y Comment.

Los nodos Element y CDATA solo se permiten en los nodos EntityReference cuando el nodo EntityReference no es un elemento secundario de un nodo Attribute.

Los atributos no son elementos secundarios de un nodo Element. Los atributos están contenidos dentro de una colección de atributos que pertenece al nodo Element.

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

Se aplica a

XmlDocument.CreateNode Método

Definición

Sobrecargas

CreateNode(String, String, String)

Parámetros

Devoluciones

Excepciones

Ejemplos

Comentarios

Se aplica a

CreateNode(XmlNodeType, String, String)

Parámetros

Devoluciones

Excepciones

Ejemplos

Comentarios

Se aplica a

CreateNode(XmlNodeType, String, String, String)

Parámetros

Devoluciones

Excepciones

Ejemplos

Comentarios

Se aplica a

Comentarios

Recursos adicionales