XmlDocument.CreateNode Metoda

Definice

Obor názvů:: System.Xml

Sestavení:: System.Xml.dll, System.Xml.XmlDocument.dll

Sestavení:: netstandard.dll, System.Xml.ReaderWriter.dll

Sestavení:: System.Xml.XmlDocument.dll

Sestavení:: System.Xml.ReaderWriter.dll

Sestavení:: System.Xml.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Vytvoří XmlNode.

Přetížení

Name	Description
CreateNode(String, String, String)	Vytvoří se zadaným typem XmlNode Nameuzlu a NamespaceURI.
CreateNode(XmlNodeType, String, String)	Vytvoří se zadaným XmlNodeparametrem XmlNodeType , Namea NamespaceURI.
CreateNode(XmlNodeType, String, String, String)	Vytvoří se zadaným XmlNodeparametrem XmlNodeType , Prefix, Namea NamespaceURI.

CreateNode(String, String, String)

Zdroj:: XmlDocument.cs

Zdroj:: XmlDocument.cs

Zdroj:: XmlDocument.cs

Zdroj:: XmlDocument.cs

Zdroj:: XmlDocument.cs

Vytvoří se zadaným typem XmlNode Nameuzlu a 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

Parametry

nodeTypeString: String

Řetězcová verze XmlNodeType nového uzlu Tento parametr musí být jednou z hodnot uvedených v následující tabulce.

name: String

Kvalifikovaný název nového uzlu. Pokud název obsahuje dvojtečku, analyzuje se do Prefix a LocalName součástí.

namespaceURI: String

Identifikátor URI oboru názvů nového uzlu.

Návraty

XmlNode

XmlNodeNový .

Výjimky

ArgumentException

Název nebyl zadaný a XmlNodeType vyžaduje název, nebo nodeTypeString není jedním z níže uvedených řetězců.

Příklady

Následující příklad vytvoří nový prvek a vloží ho do dokumentu.

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

Poznámky

V parametru nodeTypeString se rozlišují malá a velká písmena a musí se jednat o jednu z hodnot v následující tabulce.

nodeTypeString	Xmlnodetype
atribut	Attribute
cdatasection	oddíl CDATA
komentář	Comment
dokument	Dokument
Documentfragment	Documentfragment
documenttype	Typ dokumentu
element	prvek
Entityreference	EntityReference
Processinginstruction	PokynKeZpracování
significantwhitespace	SignificantWhitespace
poslat SMS	Text
prázdné znaky	Prázdné místo

I když tato metoda vytvoří nový objekt v kontextu dokumentu, nepřidá automaticky nový objekt do stromu dokumentu. Chcete-li přidat nový objekt, musíte explicitně volat jednu z metod vložení uzlu.

Následující tabulka ukazuje, co nodeType[řádek] je povoleno uvnitř jiného NodeType[column] podle doporučení W3C Extensible Markup Language (XML) 1.0.

Typ uzlu	Dokument	Typ dokumentu	Deklarace XML	prvek	Attribute	Text	oddíl CDATA	Označení	EntityReference
`Document`	Ne	Ne	Ne	Ne	Ne	Ne	Ne	Ne	Ne
`DocumentType`	Ano	Ne	Ne	Ne	Ne	Ne	Ne	Ne	Ne
`XmlDeclaration`	Ano*	Ne	Ne	Ne	Ne	Ne	Ne	Ne	Ne
`Element`	Ano	Ne	Ne	Ano	Ne	Ne	Ne	Ne	Ano†
`Attribute`	Ne	Ne	Ne	Ano^{, ano.}	Ne	Ne	Ne	Ne	Ne
`Text`	Ne	Ne	Ne	Ano	Ano	Ne	Ne	Ne	Ano
`CDATA`	Ne	Ne	Ne	Ano	Ne	Ne	Ne	Ne	Ano†
`Markup` ^§	Ano	Ne	Ne	Ano	Ne	Ne	Ne	Ne	Ne
`EntityReference`	Ne	Ne	Ne	Ano	Ano	Ne	Ne	Ne	Ano

* Uzel XmlDeclaration musí být první podřízenou položkou uzlu Dokumentu.

§ Markup zahrnuje ProcessingInstruction a Comment uzly.

Element† a CDATA uzly jsou povoleny pouze v EntityReference uzlech, pokud EntityReference uzel není podřízeným uzlemAttribute.

– Atributy nejsou podřízené Element uzlu. Atributy jsou obsaženy v kolekci atributů, která patří do Element uzlu.

Tato metoda je rozšíření Microsoft modelu DOM (Document Object Model).

Platí pro

CreateNode(XmlNodeType, String, String)

Zdroj:: XmlDocument.cs

Zdroj:: XmlDocument.cs

Zdroj:: XmlDocument.cs

Zdroj:: XmlDocument.cs

Zdroj:: XmlDocument.cs

Vytvoří se zadaným XmlNodeparametrem XmlNodeType , Namea 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);

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

Parametry

type: XmlNodeType

Nový XmlNodeType uzel.

name: String

Kvalifikovaný název nového uzlu. Pokud název obsahuje dvojtečku, analyzuje se do Prefix a LocalName komponent.

namespaceURI: String

Identifikátor URI oboru názvů nového uzlu.

Návraty

XmlNode

XmlNodeNový .

Výjimky

ArgumentException

Název nebyl zadaný a XmlNodeType vyžaduje název.

Příklady

Následující příklad vytvoří nový prvek a vloží ho do dokumentu 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

Poznámky

Následující tabulka ukazuje, co nodeType[řádek] je povoleno uvnitř jiného NodeType[column] podle doporučení W3C Extensible Markup Language (XML) 1.0.

Typ uzlu	Dokument	Typ dokumentu	Deklarace XML	prvek	Attribute	Text	oddíl CDATA	Označení	EntityReference
`Document`	Ne	Ne	Ne	Ne	Ne	Ne	Ne	Ne	Ne
`DocumentType`	Ano	Ne	Ne	Ne	Ne	Ne	Ne	Ne	Ne
`XmlDeclaration`	Ano*	Ne	Ne	Ne	Ne	Ne	Ne	Ne	Ne
`Element`	Ano	Ne	Ne	Ano	Ne	Ne	Ne	Ne	Ano†
`Attribute`	Ne	Ne	Ne	Ano, ano.	Ne	Ne	Ne	Ne	Ne
`Text`	Ne	Ne	Ne	Ano	Ano	Ne	Ne	Ne	Ano
`CDATA`	Ne	Ne	Ne	Ano	Ne	Ne	Ne	Ne	Ano†
`Markup`§	Ano	Ne	Ne	Ano	Ne	Ne	Ne	Ne	Ne
`EntityReference`	Ne	Ne	Ne	Ano	Ano	Ne	Ne	Ne	Ano

* Uzel XmlDeclaration musí být první podřízenou položkou uzlu Dokumentu.

§ Markup zahrnuje ProcessingInstruction a Comment uzly.

Element† a CDATA uzly jsou povoleny pouze v EntityReference uzlech, pokud EntityReference uzel není podřízeným uzlemAttribute.

– Atributy nejsou podřízené Element uzlu. Atributy jsou obsaženy v kolekci atributů, která patří do Element uzlu.

Tato metoda je rozšíření Microsoft modelu DOM (Document Object Model).

Platí pro

CreateNode(XmlNodeType, String, String, String)

Zdroj:: XmlDocument.cs

Zdroj:: XmlDocument.cs

Zdroj:: XmlDocument.cs

Zdroj:: XmlDocument.cs

Zdroj:: XmlDocument.cs

Vytvoří se zadaným XmlNodeparametrem XmlNodeType , Prefix, Namea 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);

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

Parametry

type: XmlNodeType

Nový XmlNodeType uzel.

prefix: String

Předpona nového uzlu.

name: String

Místní název nového uzlu.

namespaceURI: String

Identifikátor URI oboru názvů nového uzlu.

Návraty

XmlNode

XmlNodeNový .

Výjimky

ArgumentException

Název nebyl zadaný a XmlNodeType vyžaduje název.

Příklady

Následující příklad přidá do dokumentu nový prvek.

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

Poznámky

Následující tabulka ukazuje, co nodeType[řádek] je povoleno uvnitř jiného NodeType[column] podle doporučení W3C Extensible Markup Language (XML) 1.0.

	Dokument	Typ dokumentu	Deklarace XML	prvek	Attribute	Text	oddíl CDATA	Označení	EntityReference
`Document`	Ne	Ne	Ne	Ne	Ne	Ne	Ne	Ne	Ne
`DocumentType`	Ano	Ne	Ne	Ne	Ne	Ne	Ne	Ne	Ne
`XmlDeclaration`	Ano*	Ne	Ne	Ne	Ne	Ne	Ne	Ne	Ne
`Element`	Ano	Ne	Ne	Ano	Ne	Ne	Ne	Ne	Ano†
`Attribute`	Ne	Ne	Ne	Ano, ano.	Ne	Ne	Ne	Ne	Ne
`Text`	Ne	Ne	Ne	Ano	Ano	Ne	Ne	Ne	Ano
`CDATA`	Ne	Ne	Ne	Ano	Ne	Ne	Ne	Ne	Ano†
`Markup`§	Ano	Ne	Ne	Ano	Ne	Ne	Ne	Ne	Ne
`EntityReference`	Ne	Ne	Ne	Ano	Ano	Ne	Ne	Ne	Ano

* Uzel XmlDeclaration musí být první podřízenou položkou uzlu Dokumentu.

§ Markup zahrnuje ProcessingInstruction a Comment uzly.

Element† a CDATA uzly jsou povoleny pouze v EntityReference uzlech, pokud EntityReference uzel není podřízeným uzlemAttribute.

– Atributy nejsou podřízené Element uzlu. Atributy jsou obsaženy v kolekci atributů, která patří do Element uzlu.

Tato metoda je rozšíření Microsoft modelu DOM (Document Object Model).

Platí pro

Váš názor

Byla tato stránka užitečná?