XmlDocument.CreateNode Método

Definição

Espaço de Nomes:: System.Xml

Assemblagens:: System.Xml.dll, System.Xml.XmlDocument.dll

Assemblagem:: System.Xml.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Cria um XmlNode.

Sobrecargas

Name	Description
CreateNode(String, String, String)	Cria um XmlNode com o tipo de nó especificado, Name, e NamespaceURI.
CreateNode(XmlNodeType, String, String)	Cria um XmlNode com os especificados XmlNodeType, Name, e NamespaceURI.
CreateNode(XmlNodeType, String, String, String)	Cria um XmlNode com os especificados XmlNodeType, Prefix, Name, e NamespaceURI.

CreateNode(String, String, String)

Cria um XmlNode com o tipo de nó especificado, Name, e 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

Versão string do XmlNodeType novo nó. Este parâmetro deve ser um dos valores listados na tabela abaixo.

name: String

O nome qualificado do novo nó. Se o nome contiver dois pontos, ele é analisado em Prefix e LocalName componentes.

namespaceURI: String

O URI do namespace do novo nó.

Devoluções

XmlNode

O novo XmlNode.

Exceções

ArgumentException

O nome não foi fornecido e requer XmlNodeType um nome; ou nodeTypeString não é uma das strings listadas abaixo.

Exemplos

O exemplo seguinte cria um novo elemento e insere-o no documento.

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

Observações

O nodeTypeString parâmetro é sensível a maiúsculas minúsculas e deve ser um dos valores na tabela seguinte.

NodeTypeString	XmlNodeType
atributo	Attribute
cdatasection	CDATA
comentário	Comment
documento	Documento
documentfragment	DocumentFragment
tipo de documento	Tipo de Documento
elemento	Elemento
entityreference	EntityReference
processinginstruction	Instruções de processamento
Espaço em branco significativo	Espaço branco significativo
enviar SMS	Text
espaço em branco	Whitespace

Embora este método crie o novo objeto no contexto do documento, não adiciona automaticamente o novo objeto à árvore do documento. Para adicionar o novo objeto, deve chamar explicitamente um dos métodos de inserção de nó.

A tabela seguinte mostra-lhe que NodeType[row] é permitido dentro de outro NodeType[column] de acordo com a recomendação W3C Extensible Markup Language (XML) 1.0.

Tipo de nó	Documento	Tipo de Documento	Declaração XML	Elemento	Attribute	Text	CDATA	Marcação	EntityReference
`Document`	não	não	não	não	não	não	não	não	não
`DocumentType`	sim	não	não	não	não	não	não	não	não
`XmlDeclaration`	sim*	não	não	não	não	não	não	não	não
`Element`	sim	não	não	sim	não	não	não	não	Sim†
`Attribute`	não	não	não	sim^‡	não	não	não	não	não
`Text`	não	não	não	sim	sim	não	não	não	sim
`CDATA`	não	não	não	sim	não	não	não	não	Sim†
`Markup` ^§	sim	não	não	sim	não	não	não	não	não
`EntityReference`	não	não	não	sim	sim	não	não	não	sim

* O XmlDeclaration nó deve ser o primeiro filho do nó Documento.

§ Markup inclui ProcessingInstruction e Comment nós.

† Element e CDATA nós só são permitidos nos EntityReference nós quando o EntityReference nó não é filho de um Attribute nó.

‡ Os atributos não são filhos de um Element nó. Os atributos estão contidos dentro de uma coleção de atributos que pertence a um Element nó.

Este método é uma extensão da Microsoft para o Document Object Model (DOM).

Aplica-se a

CreateNode(XmlNodeType, String, String)

Cria um XmlNode com os especificados XmlNodeType, Name, e 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

O XmlNodeType do novo nó.

name: String

O nome qualificado do novo nó. Se o nome contiver dois pontos, então ele é analisado em Prefix componentes e LocalName .

namespaceURI: String

O URI do namespace do novo nó.

Devoluções

XmlNode

O novo XmlNode.

Exceções

ArgumentException

O nome não foi fornecido e requer XmlNodeType um nome.

Exemplos

O exemplo seguinte cria um novo elemento e insere-o num documento XML.

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

Observações

A tabela seguinte mostra-lhe que NodeType[row] é permitido dentro de outro NodeType[column] de acordo com a recomendação W3C Extensible Markup Language (XML) 1.0.

Tipo de nó	Documento	Tipo de Documento	Declaração XML	Elemento	Attribute	Text	CDATA	Marcação	EntityReference
`Document`	não	não	não	não	não	não	não	não	não
`DocumentType`	sim	não	não	não	não	não	não	não	não
`XmlDeclaration`	sim*	não	não	não	não	não	não	não	não
`Element`	sim	não	não	sim	não	não	não	não	Sim†
`Attribute`	não	não	não	sim‡	não	não	não	não	não
`Text`	não	não	não	sim	sim	não	não	não	sim
`CDATA`	não	não	não	sim	não	não	não	não	Sim†
`Markup`§	sim	não	não	sim	não	não	não	não	não
`EntityReference`	não	não	não	sim	sim	não	não	não	sim

* O XmlDeclaration nó deve ser o primeiro filho do nó Documento.

§ Markup inclui ProcessingInstruction e Comment nós.

† Element e CDATA nós só são permitidos nos EntityReference nós quando o EntityReference nó não é filho de um Attribute nó.

‡ Os atributos não são filhos de um Element nó. Os atributos estão contidos dentro de uma coleção de atributos que pertence a um Element nó.

Este método é uma extensão da Microsoft para o Document Object Model (DOM).

Aplica-se a

CreateNode(XmlNodeType, String, String, String)

Cria um XmlNode com os especificados XmlNodeType, Prefix, Name, e 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

O XmlNodeType do novo nó.

prefix: String

O prefixo do novo nó.

name: String

O nome local do novo nó.

namespaceURI: String

O URI do namespace do novo nó.

Devoluções

XmlNode

O novo XmlNode.

Exceções

ArgumentException

O nome não foi fornecido e requer XmlNodeType um nome.

Exemplos

O exemplo seguinte acrescenta um novo elemento ao documento.

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

Observações

A tabela seguinte mostra-lhe que NodeType[row] é permitido dentro de outro NodeType[column] de acordo com a recomendação W3C Extensible Markup Language (XML) 1.0.

	Documento	Tipo de Documento	Declaração XML	Elemento	Attribute	Text	CDATA	Marcação	EntityReference
`Document`	não	não	não	não	não	não	não	não	não
`DocumentType`	sim	não	não	não	não	não	não	não	não
`XmlDeclaration`	sim*	não	não	não	não	não	não	não	não
`Element`	sim	não	não	sim	não	não	não	não	Sim†
`Attribute`	não	não	não	sim‡	não	não	não	não	não
`Text`	não	não	não	sim	sim	não	não	não	sim
`CDATA`	não	não	não	sim	não	não	não	não	Sim†
`Markup`§	sim	não	não	sim	não	não	não	não	não
`EntityReference`	não	não	não	sim	sim	não	não	não	sim

* O nó XmlDeclaration deve ser o primeiro filho do nó Documento.

§ Markup inclui ProcessingInstruction e Comment nós.

† Element e CDATA nós só são permitidos nos EntityReference nós quando o EntityReference nó não é filho de um Attribute nó.

‡ Os atributos não são filhos de um Element nó. Os atributos estão contidos dentro de uma coleção de atributos que pertence a um Element nó.

Este método é uma extensão da Microsoft para o Document Object Model (DOM).

Aplica-se a

Comentários

Esta página foi útil?