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

Definition

Erstellt ein XmlNode.Creates an XmlNode.

Überlädt

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

Erstellt einen XmlNode mit dem angegebenen Knotentyp, Name und 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)

Erstellt einen XmlNode mit dem angegebenen XmlNodeType, Name und NamespaceURI.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)

Erstellt einen XmlNode mit dem angegebenen XmlNodeType, Prefix, Name und NamespaceURI.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)

Erstellt einen XmlNode mit dem angegebenen Knotentyp, Name und 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

Parameter

nodeTypeString
String String String String

Zeichenfolgenversion des XmlNodeType für den neuen Knoten.String version of the XmlNodeType of the new node. Dieser Parameter muss einer der in der folgenden Tabelle aufgelisteten Werte sein.This parameter must be one of the values listed in the table below.

name
String String String String

Der qualifizierte Name des neuen Knotens.The qualified name of the new node. Wenn der Name einen Doppelpunkt enthält, wird er in eine Prefix-Komponente und eine LocalName-Komponente aufgelöst.If the name contains a colon, it is parsed into Prefix and LocalName components.

namespaceURI
String String String String

Der Namespace-URI des neuen Knotens.The namespace URI of the new node.

Gibt zurück

Die neue XmlNode.The new XmlNode.

Ausnahmen

Der Name wurde nicht bereitgestellt und XmlNodeType erfordert einen Namen, oder nodeTypeString zählt nicht zu den unten aufgeführten Zeichenfolgen.The name was not provided and the XmlNodeType requires a name; or nodeTypeString is not one of the strings listed below.

Beispiele

Im folgenden Beispiel wird ein neues-Element erstellt und in das Dokument eingefügt.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

Hinweise

Beim nodeTypeString -Parameter wird die Groß-/Kleinschreibung beachtet, und es muss einer der Werte in der folgenden Tabelle sein.The nodeTypeString parameter is case sensitive and must be one of the values in the following table.

nodeTypeStringnodeTypeString XmlNodeTypeXmlNodeType
Attributattribute AttributAttribute
cdatasectioncdatasection CDATACDATA
Kommentarcomment KommentarComment
Dokumentdocument DokumentDocument
"DocumentFragment"documentfragment DocumentFragmentDocumentFragment
DocumentTypedocumenttype DocumentTypeDocumentType
Elementelement ElementElement
EntityReferenceentityreference EntityReferenceEntityReference
ProcessingInstructionprocessinginstruction ProcessingInstructionProcessingInstruction
SignificantWhitespacesignificantwhitespace SignificantWhitespaceSignificantWhitespace
Texttext TextText
whitespacewhitespace WhitespaceWhitespace

Obwohl diese Methode das neue-Objekt im Kontext des Dokuments erstellt, wird das neue-Objekt nicht automatisch der Dokumentstruktur hinzugefügt.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. Um das neue-Objekt hinzuzufügen, müssen Sie explizit eine der Knoten Einfügemethoden aufzurufen.To add the new object, you must explicitly call one of the node insert methods.

In der folgenden Tabelle wird gezeigt, wie NodeType [row] in einem anderen NodeType [Column] gemäß der W3C- Extensible Markup Language Empfehlung (XML) 1,0zulässig ist.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.

DokumentDocument DocumentTypeDocumentType XmlDeclarationXmlDeclaration ElementElement AttributAttribute TextText CDATACDATA MarkupMarkup EntityReferenceEntityReference
Document Neinno Neinno Neinno Neinno Neinno Neinno Neinno Neinno Neinno
DocumentType jayes Neinno Neinno Neinno Neinno Neinno Neinno Neinno Neinno
XmlDeclaration zwaryes* Neinno Neinno Neinno Neinno Neinno Neinno Neinno Neinno
Element jayes Neinno Neinno jayes Neinno Neinno Neinno Neinno Ja * * *yes***
Attribute Neinno Neinno Neinno Ja * * * *yes**** Neinno Neinno Neinno Neinno Neinno
Text Neinno Neinno Neinno jayes jayes Neinno Neinno Neinno jayes
CDATA Neinno Neinno Neinno jayes Neinno Neinno Neinno Neinno Ja * * *yes***
Markup** jayes Neinno Neinno jayes Neinno Neinno Neinno Neinno Neinno
EntityReference Neinno Neinno Neinno jayes jayes Neinno Neinno Neinno jayes

*Der XmlDeclaration-Knoten muss das erste untergeordnete Element des Dokument Knotens sein.* The XmlDeclaration node must be the first child of the Document node.

* * Das Markup umfasst processinginkonstruktion-und comment-Knoten.** Markup includes ProcessingInstruction and Comment nodes.

Element-und CDATA-Knoten sind nur in EntityReference-Knoten zulässig, wenn der EntityReference-Knoten kein untergeordnetes Element eines Attribut Knotens ist.*** Element and CDATA nodes are only allowed in EntityReference nodes when the EntityReference node is not a child of an Attribute node.

Attribute sind keine untergeordneten Elemente eines Element Knotens.**** Attributes are not children of an Element node. Attribute sind in einer Attribut Auflistung enthalten, die zu einem Element Knoten gehört.Attributes are contained inside an attribute collection that belongs to an Element node.

Diese Methode ist eine Microsoft-Erweiterung für die Dokumentobjektmodell (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)

Erstellt einen XmlNode mit dem angegebenen XmlNodeType, Name und NamespaceURI.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

Parameter

type
XmlNodeType XmlNodeType XmlNodeType XmlNodeType

Der XmlNodeType des neuen Knotens.The XmlNodeType of the new node.

name
String String String String

Der qualifizierte Name des neuen Knotens.The qualified name of the new node. Wenn der Name einen Doppelpunkt enthält, wird er in eine Prefix-Komponente und eine LocalName-Komponente aufgelöst.If the name contains a colon then it is parsed into Prefix and LocalName components.

namespaceURI
String String String String

Der Namespace-URI des neuen Knotens.The namespace URI of the new node.

Gibt zurück

Die neue XmlNode.The new XmlNode.

Ausnahmen

Der Name wurde nicht bereitgestellt, und XmlNodeType erfordert einen Namen.The name was not provided and the XmlNodeType requires a name.

Beispiele

Im folgenden Beispiel wird ein neues-Element erstellt und in ein XML-Dokument eingefügt.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

Hinweise

Obwohl diese Methode das neue-Objekt im Kontext des Dokuments erstellt, wird das neue-Objekt nicht automatisch der Dokumentstruktur hinzugefügt.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. Um das neue-Objekt hinzuzufügen, müssen Sie explizit eine der Knoten Einfügemethoden aufzurufen.To add the new object, you must explicitly call one of the node insert methods.

In der folgenden Tabelle wird gezeigt, wie NodeType [row] in einem anderen NodeType [Column] gemäß der W3C- Extensible Markup Language Empfehlung (XML) 1,0zulässig ist.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.

DokumentDocument DocumentTypeDocumentType XmlDeclarationXmlDeclaration ElementElement AttributAttribute TextText CDATACDATA MarkupMarkup EntityReferenceEntityReference
Document Neinno Neinno Neinno Neinno Neinno Neinno Neinno Neinno Neinno
DocumentType jayes Neinno Neinno Neinno Neinno Neinno Neinno Neinno Neinno
XmlDeclaration zwaryes* Neinno Neinno Neinno Neinno Neinno Neinno Neinno Neinno
Element jayes Neinno Neinno jayes Neinno Neinno Neinno Neinno Ja * * *yes***
Attribute Neinno Neinno Neinno Ja * * * *yes**** Neinno Neinno Neinno Neinno Neinno
Text Neinno Neinno Neinno jayes jayes Neinno Neinno Neinno jayes
CDATA Neinno Neinno Neinno jayes Neinno Neinno Neinno Neinno Ja * * *yes***
Markup** jayes Neinno Neinno jayes Neinno Neinno Neinno Neinno Neinno
EntityReference Neinno Neinno Neinno jayes jayes Neinno Neinno Neinno jayes

*Der XmlDeclaration-Knoten muss das erste untergeordnete Element des Dokument Knotens sein.* The XmlDeclaration node must be the first child of the Document node.

* * Das Markup umfasst processinginkonstruktion-und comment-Knoten.** Markup includes ProcessingInstruction and Comment nodes.

Element-und CDATA-Knoten sind nur in EntityReference-Knoten zulässig, wenn der EntityReference-Knoten kein untergeordnetes Element eines Attribut Knotens ist.*** Element and CDATA nodes are only allowed in EntityReference nodes when the EntityReference node is not a child of an Attribute node.

Attribute sind keine untergeordneten Elemente eines Element Knotens.**** Attributes are not children of an Element node. Attribute sind in einer Attribut Auflistung enthalten, die zu einem Element Knoten gehört.Attributes are contained inside an attribute collection that belongs to an Element node.

Diese Methode ist eine Microsoft-Erweiterung für die Dokumentobjektmodell (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)

Erstellt einen XmlNode mit dem angegebenen XmlNodeType, Prefix, Name und NamespaceURI.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

Parameter

type
XmlNodeType XmlNodeType XmlNodeType XmlNodeType

Der XmlNodeType des neuen Knotens.The XmlNodeType of the new node.

prefix
String String String String

Das Präfix des neuen Knotens.The prefix of the new node.

name
String String String String

Der lokale Name des neuen Knotens.The local name of the new node.

namespaceURI
String String String String

Der Namespace-URI des neuen Knotens.The namespace URI of the new node.

Gibt zurück

Die neue XmlNode.The new XmlNode.

Ausnahmen

Der Name wurde nicht bereitgestellt, und XmlNodeType erfordert einen Namen.The name was not provided and the XmlNodeType requires a name.

Beispiele

Im folgenden Beispiel wird dem Dokument ein neues-Element hinzugefügt.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

Hinweise

Obwohl diese Methode das neue-Objekt im Kontext des Dokuments erstellt, wird das neue-Objekt nicht automatisch der Dokumentstruktur hinzugefügt.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. Um das neue-Objekt hinzuzufügen, müssen Sie explizit eine der Knoten Einfügemethoden aufzurufen.To add the new object, you must explicitly call one of the node insert methods.

In der folgenden Tabelle wird gezeigt, wie NodeType [row] in einem anderen NodeType [Column] gemäß der W3C- Extensible Markup Language Empfehlung (XML) 1,0zulässig ist.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.

DokumentDocument DocumentTypeDocumentType XmlDeclarationXmlDeclaration ElementElement AttributAttribute TextText CDATACDATA MarkupMarkup EntityReferenceEntityReference
Document Neinno Neinno Neinno Neinno Neinno Neinno Neinno Neinno Neinno
DocumentType jayes Neinno Neinno Neinno Neinno Neinno Neinno Neinno Neinno
XmlDeclaration zwaryes* Neinno Neinno Neinno Neinno Neinno Neinno Neinno Neinno
Element jayes Neinno Neinno jayes Neinno Neinno Neinno Neinno Ja * * *yes***
Attribute Neinno Neinno Neinno Ja * * * *yes**** Neinno Neinno Neinno Neinno Neinno
Text Neinno Neinno Neinno jayes jayes Neinno Neinno Neinno jayes
CDATA Neinno Neinno Neinno jayes Neinno Neinno Neinno Neinno Ja * * *yes***
Markup** jayes Neinno Neinno jayes Neinno Neinno Neinno Neinno Neinno
EntityReference Neinno Neinno Neinno jayes jayes Neinno Neinno Neinno jayes

*Der XmlDeclaration-Knoten muss das erste untergeordnete Element des Dokument Knotens sein.* The XmlDeclaration node must be the first child of the Document node.

* * Das Markup umfasst processinginkonstruktion-und comment-Knoten.** Markup includes ProcessingInstruction and Comment nodes.

Element-und CDATA-Knoten sind nur in EntityReference-Knoten zulässig, wenn der EntityReference-Knoten kein untergeordnetes Element eines Attribut Knotens ist.*** Element and CDATA nodes are only allowed in EntityReference nodes when the EntityReference node is not a child of an Attribute node.

Attribute sind keine untergeordneten Elemente eines Element Knotens.**** Attributes are not children of an Element node. Attribute sind in einer Attribut Auflistung enthalten, die zum Element Knoten gehört.Attributes are contained inside an attribute collection that belongs to the Element node.

Diese Methode ist eine Microsoft-Erweiterung für die Dokumentobjektmodell (DOM).This method is a Microsoft extension to the Document Object Model (DOM).

Gilt für: