XmlDocument.CreateNode XmlDocument.CreateNode XmlDocument.CreateNode XmlDocument.CreateNode Method

Definición

Crea una interfaz XmlNode.Creates an XmlNode.

Sobrecargas

CreateNode(String, String, String) CreateNode(String, String, String) CreateNode(String, String, String) CreateNode(String, String, String)

Crea un XmlNode con el tipo de nodo especificado, Name y NamespaceURI.Creates an XmlNode with the specified node type, Name, and NamespaceURI.

CreateNode(XmlNodeType, String, String) CreateNode(XmlNodeType, String, String) CreateNode(XmlNodeType, String, String) CreateNode(XmlNodeType, String, String)

Crea un XmlNode con los XmlNodeType, Name y NamespaceURI especificados.Creates an XmlNode with the specified XmlNodeType, Name, and NamespaceURI.

CreateNode(XmlNodeType, String, String, String) CreateNode(XmlNodeType, String, String, String) CreateNode(XmlNodeType, String, String, String) CreateNode(XmlNodeType, String, String, String)

Crea un XmlNode con los XmlNodeType, Prefix, Name y NamespaceURI especificados.Creates a XmlNode with the specified XmlNodeType, Prefix, Name, and NamespaceURI.

CreateNode(String, String, String) CreateNode(String, String, String) CreateNode(String, String, String) CreateNode(String, String, String)

Crea un XmlNode con el tipo de nodo especificado, Name y NamespaceURI.Creates an XmlNode with the specified node type, Name, and 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);
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 String String String

Versión de cadena del XmlNodeType del nuevo nodo.String version of the XmlNodeType of the new node. Este parámetro debe ser uno de los valores de la tabla que figura más abajo.This parameter must be one of the values listed in the table below.

name
String String String String

Nombre completo del nuevo nodo.The qualified name of the new node. Si el nombre contiene un carácter de dos puntos, se analiza en los componentes Prefix y LocalName.If the name contains a colon, it is parsed into Prefix and LocalName components.

namespaceURI
String String String String

Identificador URI de espacio de nombres del nuevo nodo.The namespace URI of the new node.

Devoluciones

Nuevo objeto XmlNode.The new XmlNode.

Excepciones

No se ha proporcionado el nombre y XmlNodeType requiere un nombre; o nodeTypeString no es una de las cadenas enumeradas a continuación.The name was not provided and the XmlNodeType requires a name; or nodeTypeString is not one of the strings listed below.

Ejemplos

En el ejemplo siguiente se crea un nuevo elemento y se inserta en el documento.The following example creates a new element and inserts it into the document.

#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 entre mayúsculas y minúsculas y debe ser uno de los valores de la tabla siguiente.The nodeTypeString parameter is case sensitive and must be one of the values in the following table.

nodeTypeStringnodeTypeString Tipo XmlNodeXmlNodeType
Atributoattribute AtributoAttribute
cdatasectioncdatasection CDATACDATA
comentariocomment ComentarioComment
documentodocument DocumentoDocument
DocumentFragmentdocumentfragment DocumentFragmentDocumentFragment
DocumentTypedocumenttype DocumentTypeDocumentType
elementoelement ElementoElement
EntityReferenceentityreference EntityReferenceEntityReference
instrucciónprocessinginstruction ProcessingInstructionProcessingInstruction
significantwhitespacesignificantwhitespace SignificantWhitespaceSignificantWhitespace
textotext TextoText
whitespacewhitespace WhitespaceWhitespace

Aunque este método crea el nuevo objeto en el contexto del documento, no agrega automáticamente el nuevo objeto al árbol del documento.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. Para agregar el nuevo objeto, debe llamar explícitamente a uno de los métodos de inserción de nodo.To add the new object, you must explicitly call one of the node insert methods.

En la tabla siguiente se muestra qué NodeType [Row] se permite dentro de otro NodeType [column] según la recomendación del W3C lenguaje de marcado extensible (XML) 1,0.The following table shows you what NodeType[row] is allowed inside another NodeType[column] according to the W3C Extensible Markup Language (XML) 1.0 recommendation.

DocumentoDocument DocumentTypeDocumentType XmlDeclarationXmlDeclaration ElementoElement AtributoAttribute TextoText CDATACDATA marcadoMarkup EntityReferenceEntityReference
Document Nono Nono Nono Nono Nono Nono Nono Nono Nono
DocumentType yes Nono Nono Nono Nono Nono Nono Nono Nono
XmlDeclaration ?yes* Nono Nono Nono Nono Nono Nono Nono Nono
Element yes Nono Nono yes Nono Nono Nono Nono sí * * *yes***
Attribute Nono Nono Nono sí * * * *yes**** Nono Nono Nono Nono Nono
Text Nono Nono Nono yes yes Nono Nono Nono yes
CDATA Nono Nono Nono yes Nono Nono Nono Nono sí * * *yes***
Markup** yes Nono Nono yes Nono Nono Nono Nono Nono
EntityReference Nono Nono Nono yes yes Nono Nono Nono yes

*El nodo XmlDeclaration debe ser el primer elemento secundario del nodo de documento.* The XmlDeclaration node must be the first child of the Document node.

* * El marcado incluye nodos ProcessingInstruction y comment.** Markup includes ProcessingInstruction and Comment nodes.

Los nodos ELEMENT y CDATA solo se permiten en nodos EntityReference cuando el nodo EntityReference no es un elemento secundario de un nodo de atributo.*** Element and CDATA nodes are only allowed in EntityReference nodes when the EntityReference node is not a child of an Attribute node.

Los atributos no son elementos secundarios de un nodo de elemento.**** Attributes are not children of an Element node. Los atributos se encuentran dentro de una colección de atributos que pertenece a un nodo de elemento.Attributes are contained inside an attribute collection that belongs to an Element node.

Este método es una extensión de Microsoft para el Document Object Model (DOM).This method is a Microsoft extension to the Document Object Model (DOM).

CreateNode(XmlNodeType, String, String) CreateNode(XmlNodeType, String, String) CreateNode(XmlNodeType, String, String) CreateNode(XmlNodeType, String, String)

Crea un XmlNode con los XmlNodeType, Name y NamespaceURI especificados.Creates an XmlNode with the specified XmlNodeType, Name, and NamespaceURI.

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);
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 XmlNodeType XmlNodeType

XmlNodeType del nuevo nodo.The XmlNodeType of the new node.

name
String String String String

Nombre completo del nuevo nodo.The qualified name of the new node. Si el nombre contiene un carácter de dos puntos, se analiza en los componentes Prefix y LocalName.If the name contains a colon then it is parsed into Prefix and LocalName components.

namespaceURI
String String String String

Identificador URI de espacio de nombres del nuevo nodo.The namespace URI of the new node.

Devoluciones

Nuevo objeto XmlNode.The new XmlNode.

Excepciones

No se ha proporcionado el nombre y XmlNodeType requiere un nombre.The name was not provided and the XmlNodeType requires a name.

Ejemplos

En el ejemplo siguiente se crea un nuevo elemento y se inserta en un documento XML.The following example creates a new element and inserts it into an 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;
   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

Aunque este método crea el nuevo objeto en el contexto del documento, no agrega automáticamente el nuevo objeto al árbol del documento.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. Para agregar el nuevo objeto, debe llamar explícitamente a uno de los métodos de inserción de nodo.To add the new object, you must explicitly call one of the node insert methods.

En la tabla siguiente se muestra qué NodeType [Row] se permite dentro de otro NodeType [column] según la recomendación del W3C lenguaje de marcado extensible (XML) 1,0.The following table shows you what NodeType[row] is allowed inside another NodeType[column] according to the W3C Extensible Markup Language (XML) 1.0 recommendation.

DocumentoDocument DocumentTypeDocumentType XmlDeclarationXmlDeclaration ElementoElement AtributoAttribute TextoText CDATACDATA marcadoMarkup EntityReferenceEntityReference
Document Nono Nono Nono Nono Nono Nono Nono Nono Nono
DocumentType yes Nono Nono Nono Nono Nono Nono Nono Nono
XmlDeclaration ?yes* Nono Nono Nono Nono Nono Nono Nono Nono
Element yes Nono Nono yes Nono Nono Nono Nono sí * * *yes***
Attribute Nono Nono Nono sí * * * *yes**** Nono Nono Nono Nono Nono
Text Nono Nono Nono yes yes Nono Nono Nono yes
CDATA Nono Nono Nono yes Nono Nono Nono Nono sí * * *yes***
Markup** yes Nono Nono yes Nono Nono Nono Nono Nono
EntityReference Nono Nono Nono yes yes Nono Nono Nono yes

*El nodo XmlDeclaration debe ser el primer elemento secundario del nodo de documento.* The XmlDeclaration node must be the first child of the Document node.

* * El marcado incluye nodos ProcessingInstruction y comment.** Markup includes ProcessingInstruction and Comment nodes.

Los nodos ELEMENT y CDATA solo se permiten en nodos EntityReference cuando el nodo EntityReference no es un elemento secundario de un nodo de atributo.*** Element and CDATA nodes are only allowed in EntityReference nodes when the EntityReference node is not a child of an Attribute node.

Los atributos no son elementos secundarios de un nodo de elemento.**** Attributes are not children of an Element node. Los atributos se encuentran dentro de una colección de atributos que pertenece a un nodo de elemento.Attributes are contained inside an attribute collection that belongs to an Element node.

Este método es una extensión de Microsoft para el Document Object Model (DOM).This method is a Microsoft extension to the Document Object Model (DOM).

CreateNode(XmlNodeType, String, String, String) CreateNode(XmlNodeType, String, String, String) CreateNode(XmlNodeType, String, String, String) CreateNode(XmlNodeType, String, String, String)

Crea un XmlNode con los XmlNodeType, Prefix, Name y NamespaceURI especificados.Creates a XmlNode with the specified XmlNodeType, Prefix, Name, and NamespaceURI.

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);
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 XmlNodeType XmlNodeType

XmlNodeType del nuevo nodo.The XmlNodeType of the new node.

prefix
String String String String

Prefijo del nuevo nodo.The prefix of the new node.

name
String String String String

Nombre local del nuevo nodo.The local name of the new node.

namespaceURI
String String String String

Identificador URI de espacio de nombres del nuevo nodo.The namespace URI of the new node.

Devoluciones

Nuevo objeto XmlNode.The new XmlNode.

Excepciones

No se ha proporcionado el nombre y XmlNodeType requiere un nombre.The name was not provided and the XmlNodeType requires a name.

Ejemplos

En el siguiente ejemplo se agrega un nuevo elemento al documento.The following example adds a new element to the document.

#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

Aunque este método crea el nuevo objeto en el contexto del documento, no agrega automáticamente el nuevo objeto al árbol del documento.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. Para agregar el nuevo objeto, debe llamar explícitamente a uno de los métodos de inserción de nodo.To add the new object, you must explicitly call one of the node insert methods.

En la tabla siguiente se muestra qué NodeType [Row] se permite dentro de otro NodeType [column] según la recomendación del W3C lenguaje de marcado extensible (XML) 1,0.The following table shows you what NodeType[row] is allowed inside another NodeType[column] according to the W3C Extensible Markup Language (XML) 1.0 recommendation.

DocumentoDocument DocumentTypeDocumentType XmlDeclarationXmlDeclaration ElementoElement AtributoAttribute TextoText CDATACDATA marcadoMarkup EntityReferenceEntityReference
Document Nono Nono Nono Nono Nono Nono Nono Nono Nono
DocumentType yes Nono Nono Nono Nono Nono Nono Nono Nono
XmlDeclaration ?yes* Nono Nono Nono Nono Nono Nono Nono Nono
Element yes Nono Nono yes Nono Nono Nono Nono sí * * *yes***
Attribute Nono Nono Nono sí * * * *yes**** Nono Nono Nono Nono Nono
Text Nono Nono Nono yes yes Nono Nono Nono yes
CDATA Nono Nono Nono yes Nono Nono Nono Nono sí * * *yes***
Markup** yes Nono Nono yes Nono Nono Nono Nono Nono
EntityReference Nono Nono Nono yes yes Nono Nono Nono yes

*El nodo XmlDeclaration debe ser el primer elemento secundario del nodo de documento.* The XmlDeclaration node must be the first child of the Document node.

* * El marcado incluye nodos ProcessingInstruction y comment.** Markup includes ProcessingInstruction and Comment nodes.

Los nodos ELEMENT y CDATA solo se permiten en nodos EntityReference cuando el nodo EntityReference no es un elemento secundario de un nodo de atributo.*** Element and CDATA nodes are only allowed in EntityReference nodes when the EntityReference node is not a child of an Attribute node.

Los atributos no son elementos secundarios de un nodo de elemento.**** Attributes are not children of an Element node. Los atributos se encuentran dentro de una colección de atributos que pertenece al nodo de elemento.Attributes are contained inside an attribute collection that belongs to the Element node.

Este método es una extensión de Microsoft para el Document Object Model (DOM).This method is a Microsoft extension to the Document Object Model (DOM).

Se aplica a