XmlDocument.CreateNode Methode

Definitie

Naamruimte:: System.Xml

Assembly's:: System.Xml.dll, System.Xml.XmlDocument.dll

Assembly's:: netstandard.dll, System.Xml.ReaderWriter.dll

Assembly:: System.Xml.XmlDocument.dll

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee maakt u een XmlNode.

Overloads

Name	Description
CreateNode(String, String, String)	Hiermee maakt u een XmlNode met het opgegeven knooppunttype, Nameen NamespaceURI.
CreateNode(XmlNodeType, String, String)	Hiermee maakt u een XmlNode met de opgegeven XmlNodeType, Nameen NamespaceURI.
CreateNode(XmlNodeType, String, String, String)	Hiermee maakt u een XmlNode met de opgegeven XmlNodeType, Prefix, en Name NamespaceURI.

CreateNode(String, String, String)

Bron:: XmlDocument.cs

Bron:: XmlDocument.cs

Bron:: XmlDocument.cs

Bron:: XmlDocument.cs

Bron:: XmlDocument.cs

Hiermee maakt u een XmlNode met het opgegeven knooppunttype, Nameen 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

Parameters

nodeTypeString: String

Tekenreeksversie van het XmlNodeType nieuwe knooppunt. Deze parameter moet een van de waarden zijn die worden vermeld in de onderstaande tabel.

name: String

De gekwalificeerde naam van het nieuwe knooppunt. Als de naam een dubbele punt bevat, wordt deze geparseerd in Prefix en LocalName onderdelen.

namespaceURI: String

De naamruimte-URI van het nieuwe knooppunt.

Retouren

XmlNode

Het nieuwe XmlNode.

Uitzonderingen

ArgumentException

De naam is niet opgegeven en hiervoor XmlNodeType is een naam vereist; of nodeTypeString is geen van de onderstaande tekenreeksen.

Voorbeelden

In het volgende voorbeeld wordt een nieuw element gemaakt en ingevoegd in het document.

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

Opmerkingen

De nodeTypeString parameter is hoofdlettergevoelig en moet een van de waarden in de volgende tabel zijn.

nodeTypeString	XmlNodeType
attribuut	Attribute
cdatasection	CDATA
reactie	Comment
document	Document
documentfragment	DocumentFragment
documenttype	DocumentType
element	Element
entityreference	EntityReference
verwerkingsinstructie	Verwerkingsinstructie
significantwhitespace	SignificanteWitruimte
text	Tekst
spatie	Witte ruimte

Hoewel met deze methode het nieuwe object wordt gemaakt in de context van het document, wordt het nieuwe object niet automatisch toegevoegd aan de documentstructuur. Als u het nieuwe object wilt toevoegen, moet u expliciet een van de methoden voor het invoegen van knooppunten aanroepen.

In de volgende tabel ziet u wat NodeType[row] is toegestaan binnen een ander NodeType[kolom] volgens de aanbeveling W3C Extensible Markup Language (XML) 1.0.

Knooppunttype	Document	DocumentType	XmlDeclaratie	Element	Attribute	Tekst	CDATA	Opmaak	EntityReference
`Document`	nee	nee	nee	nee	nee	nee	nee	nee	nee
`DocumentType`	Ja	nee	nee	nee	nee	nee	nee	nee	nee
`XmlDeclaration`	Ja*	nee	nee	nee	nee	nee	nee	nee	nee
`Element`	Ja	nee	nee	Ja	nee	nee	nee	nee	Ja†
`Attribute`	nee	nee	nee	Ja^‡	nee	nee	nee	nee	nee
`Text`	nee	nee	nee	Ja	Ja	nee	nee	nee	Ja
`CDATA`	nee	nee	nee	Ja	nee	nee	nee	nee	Ja†
`Markup` ^§	Ja	nee	nee	Ja	nee	nee	nee	nee	nee
`EntityReference`	nee	nee	nee	Ja	Ja	nee	nee	nee	Ja

* Het XmlDeclaration knooppunt moet het eerste onderliggende element van het documentknooppunt zijn.

§ Markup bevat ProcessingInstruction en Comment knooppunten.

Element† en CDATA knooppunten zijn alleen toegestaan in EntityReference knooppunten wanneer het EntityReference knooppunt geen onderliggend element van een Attribute knooppunt is.

‡ Kenmerken zijn geen onderliggende elementen van een Element knooppunt. Kenmerken bevinden zich in een kenmerkverzameling die deel uitmaakt van een Element knooppunt.

Deze methode is een Microsoft extensie voor het Document Object Model (DOM).

Van toepassing op

CreateNode(XmlNodeType, String, String)

Bron:: XmlDocument.cs

Bron:: XmlDocument.cs

Bron:: XmlDocument.cs

Bron:: XmlDocument.cs

Bron:: XmlDocument.cs

Hiermee maakt u een XmlNode met de opgegeven XmlNodeType, Nameen 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

Parameters

type: XmlNodeType

Het XmlNodeType nieuwe knooppunt.

name: String

De gekwalificeerde naam van het nieuwe knooppunt. Als de naam een dubbele punt bevat, wordt deze geparseerd in Prefix en LocalName onderdelen.

namespaceURI: String

De naamruimte-URI van het nieuwe knooppunt.

Retouren

XmlNode

Het nieuwe XmlNode.

Uitzonderingen

ArgumentException

De naam is niet opgegeven en hiervoor XmlNodeType is een naam vereist.

Voorbeelden

In het volgende voorbeeld wordt een nieuw element gemaakt en ingevoegd in een XML-document.

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

Opmerkingen

In de volgende tabel ziet u wat NodeType[row] is toegestaan binnen een ander NodeType[kolom] volgens de aanbeveling W3C Extensible Markup Language (XML) 1.0.

Knooppunttype	Document	DocumentType	XmlDeclaratie	Element	Attribute	Tekst	CDATA	Opmaak	EntityReference
`Document`	nee	nee	nee	nee	nee	nee	nee	nee	nee
`DocumentType`	Ja	nee	nee	nee	nee	nee	nee	nee	nee
`XmlDeclaration`	Ja*	nee	nee	nee	nee	nee	nee	nee	nee
`Element`	Ja	nee	nee	Ja	nee	nee	nee	nee	Ja†
`Attribute`	nee	nee	nee	Ja‡	nee	nee	nee	nee	nee
`Text`	nee	nee	nee	Ja	Ja	nee	nee	nee	Ja
`CDATA`	nee	nee	nee	Ja	nee	nee	nee	nee	Ja†
`Markup`§	Ja	nee	nee	Ja	nee	nee	nee	nee	nee
`EntityReference`	nee	nee	nee	Ja	Ja	nee	nee	nee	Ja

* Het XmlDeclaration knooppunt moet het eerste onderliggende element van het documentknooppunt zijn.

§ Markup bevat ProcessingInstruction en Comment knooppunten.

Element† en CDATA knooppunten zijn alleen toegestaan in EntityReference knooppunten wanneer het EntityReference knooppunt geen onderliggend element van een Attribute knooppunt is.

‡ Kenmerken zijn geen onderliggende elementen van een Element knooppunt. Kenmerken bevinden zich in een kenmerkverzameling die deel uitmaakt van een Element knooppunt.

Deze methode is een Microsoft extensie voor het Document Object Model (DOM).

Van toepassing op

CreateNode(XmlNodeType, String, String, String)

Bron:: XmlDocument.cs

Bron:: XmlDocument.cs

Bron:: XmlDocument.cs

Bron:: XmlDocument.cs

Bron:: XmlDocument.cs

Hiermee maakt u een XmlNode met de opgegeven XmlNodeType, Prefix, en Name 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

Parameters

type: XmlNodeType

Het XmlNodeType nieuwe knooppunt.

prefix: String

Het voorvoegsel van het nieuwe knooppunt.

name: String

De lokale naam van het nieuwe knooppunt.

namespaceURI: String

De naamruimte-URI van het nieuwe knooppunt.

Retouren

XmlNode

Het nieuwe XmlNode.

Uitzonderingen

ArgumentException

De naam is niet opgegeven en hiervoor XmlNodeType is een naam vereist.

Voorbeelden

In het volgende voorbeeld wordt een nieuw element aan het document toegevoegd.

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

Opmerkingen

In de volgende tabel ziet u wat NodeType[row] is toegestaan binnen een ander NodeType[kolom] volgens de aanbeveling W3C Extensible Markup Language (XML) 1.0.

	Document	DocumentType	XmlDeclaratie	Element	Attribute	Tekst	CDATA	Opmaak	EntityReference
`Document`	nee	nee	nee	nee	nee	nee	nee	nee	nee
`DocumentType`	Ja	nee	nee	nee	nee	nee	nee	nee	nee
`XmlDeclaration`	Ja*	nee	nee	nee	nee	nee	nee	nee	nee
`Element`	Ja	nee	nee	Ja	nee	nee	nee	nee	Ja†
`Attribute`	nee	nee	nee	Ja‡	nee	nee	nee	nee	nee
`Text`	nee	nee	nee	Ja	Ja	nee	nee	nee	Ja
`CDATA`	nee	nee	nee	Ja	nee	nee	nee	nee	Ja†
`Markup`§	Ja	nee	nee	Ja	nee	nee	nee	nee	nee
`EntityReference`	nee	nee	nee	Ja	Ja	nee	nee	nee	Ja

* Het knooppunt XmlDeclaration moet het eerste onderliggende element van het documentknooppunt zijn.

§ Markup bevat ProcessingInstruction en Comment knooppunten.

Element† en CDATA knooppunten zijn alleen toegestaan in EntityReference knooppunten wanneer het EntityReference knooppunt geen onderliggend element van een Attribute knooppunt is.

‡ Kenmerken zijn geen onderliggende elementen van een Element knooppunt. Kenmerken bevinden zich in een kenmerkverzameling die deel uitmaakt van een Element knooppunt.

Deze methode is een Microsoft extensie voor het Document Object Model (DOM).

Van toepassing op

Feedback

Is deze pagina nuttig?