XmlDocument.CreateNode Methode

Referenz

Definition

Namespace:: System.Xml

Assemblys:: System.Xml.dll, System.Xml.XmlDocument.dll

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.XmlDocument.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Erstellt ein XmlNode.

Überlädt

CreateNode(String, String, String)	Erstellt einen XmlNode mit dem angegebenen Knotentyp, Name und NamespaceURI.
CreateNode(XmlNodeType, String, String)	Erstellt einen XmlNode mit dem angegebenen XmlNodeType, Name und NamespaceURI.
CreateNode(XmlNodeType, String, String, String)	Erstellt einen XmlNode mit dem angegebenen XmlNodeType, Prefix, Name und NamespaceURI.

CreateNode(String, String, String)

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

Parameter

nodeTypeString: String

Zeichenfolgenversion des XmlNodeType für den neuen Knoten. Dieser Parameter muss einer der in der folgenden Tabelle aufgelisteten Werte sein.

name: String

Der qualifizierte Name des neuen Knotens. Wenn der Name einen Doppelpunkt enthält, wird er in eine Prefix-Komponente und eine LocalName-Komponente aufgelöst.

namespaceURI: String

Der Namespace-URI des neuen Knotens.

Gibt zurück

XmlNode

Die neue XmlNode.

Ausnahmen

ArgumentException

Der Name wurde nicht bereitgestellt und XmlNodeType erfordert einen Namen, oder nodeTypeString zählt nicht zu den unten aufgeführten Zeichenfolgen.

Beispiele

Im folgenden Beispiel wird ein neues Element erstellt und in das Dokument eingefügt.

#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

Der nodeTypeString Parameter ist groß und muss eine der Werte in der folgenden Tabelle sein.

nodeTypeString	XmlNodeType
Attribut	attribute
cdatasection	CDATA
comment	Kommentar
Dokument	Dokument
documentfragment	DocumentFragment
Documenttype	DocumentType
element	Element
Entityreference	EntityReference
Processinginstruction	ProcessingInstruction
signifikanterWhitespace	SignificantWhitespace
Text	Text
whitespace	Leerraum

Obwohl diese Methode das neue Objekt im Kontext des Dokuments erstellt, wird das neue Objekt nicht automatisch zur Dokumentstruktur hinzugefügt. Um das neue Objekt hinzuzufügen, müssen Sie explizit eine der Methoden zum Einfügen von Knoten aufrufen.

In der folgenden Tabelle wird gezeigt, was NodeType[row] innerhalb eines anderen NodeType[column] gemäß der Empfehlung von W3C Extensible Markup Language (XML) 1.0 zulässig ist.

	Dokument	DocumentType	XmlDeclaration	Element	attribute	Text	CDATA	Markup	EntityReference
`Document`	nein	nein	nein	nein	nein	nein	nein	nein	nein
`DocumentType`	ja	nein	nein	nein	nein	nein	nein	nein	nein
`XmlDeclaration`	Ja*	nein	nein	nein	nein	nein	nein	nein	nein
`Element`	ja	nein	nein	ja	nein	nein	nein	nein	Ja***
`Attribute`	nein	nein	nein	Ja****	nein	nein	nein	nein	nein
`Text`	nein	nein	nein	ja	ja	nein	nein	nein	ja
`CDATA`	nein	nein	nein	ja	nein	nein	nein	nein	Ja***
`Markup**`	ja	nein	nein	ja	nein	nein	nein	nein	nein
`EntityReference`	nein	nein	nein	ja	ja	nein	nein	nein	ja

* Der XmlDeclaration-Knoten muss das erste untergeordnete Element des Dokumentknotens sein.

** Markup umfasst ProcessingInstruction und Kommentarknoten.

Elemente und CDATA-Knoten sind nur in EntityReference-Knoten zulässig, wenn der EntityReference-Knoten kein untergeordnetes Element eines Attributknotens ist.

Attribute sind keine untergeordneten Elemente eines Elementknotens. Attribute sind in einer Attributauflistung enthalten, die zu einem Elementknoten gehört.

Diese Methode ist eine Microsoft-Erweiterung für das Dokumentobjektmodell (DOM).

Gilt für

CreateNode(XmlNodeType, String, String)

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

Parameter

type: XmlNodeType

Der XmlNodeType des neuen Knotens.

name: String

Der qualifizierte Name des neuen Knotens. Wenn der Name einen Doppelpunkt enthält, wird er in eine Prefix-Komponente und eine LocalName-Komponente aufgelöst.

namespaceURI: String

Der Namespace-URI des neuen Knotens.

Gibt zurück

XmlNode

Die neue XmlNode.

Ausnahmen

ArgumentException

Der Name wurde nicht bereitgestellt, und XmlNodeType erfordert einen Namen.

Beispiele

Im folgenden Beispiel wird ein neues Element erstellt und in ein XML-Dokument eingefügt.

#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. Um das neue Objekt hinzuzufügen, müssen Sie explizit eine der Methoden zum Einfügen von Knoten aufrufen.

In der folgenden Tabelle wird gezeigt, welche NodeType[zeile] innerhalb eines anderen NodeType[column] gemäß der Empfehlung von W3C Extensible Markup Language (XML) 1.0 zulässig ist.

	Dokument	DocumentType	XmlDeclaration	Element	attribute	Text	CDATA	Markup	EntityReference
`Document`	nein	nein	nein	nein	nein	nein	nein	nein	nein
`DocumentType`	ja	nein	nein	nein	nein	nein	nein	nein	nein
`XmlDeclaration`	Ja*	nein	nein	nein	nein	nein	nein	nein	nein
`Element`	ja	nein	nein	ja	nein	nein	nein	nein	Ja***
`Attribute`	nein	nein	nein	Ja****	nein	nein	nein	nein	nein
`Text`	nein	nein	nein	ja	ja	nein	nein	nein	ja
`CDATA`	nein	nein	nein	ja	nein	nein	nein	nein	Ja***
`Markup**`	ja	nein	nein	ja	nein	nein	nein	nein	nein
`EntityReference`	nein	nein	nein	ja	ja	nein	nein	nein	ja

* Der XmlDeclaration-Knoten muss das erste untergeordnete Element des Dokumentknotens sein.

** Markup umfasst ProcessingInstruction und Kommentarknoten.

Elemente und CDATA-Knoten sind nur in EntityReference-Knoten zulässig, wenn der EntityReference-Knoten kein untergeordnetes Element eines Attributknotens ist.

Attribute sind keine untergeordneten Elemente eines Elementknotens. Attribute sind in einer Attributauflistung enthalten, die zu einem Elementknoten gehört.

Diese Methode ist eine Microsoft-Erweiterung für das Dokumentobjektmodell (DOM).

Gilt für

CreateNode(XmlNodeType, String, String, String)

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

Parameter

type: XmlNodeType

Der XmlNodeType des neuen Knotens.

prefix: String

Das Präfix des neuen Knotens.

name: String

Der lokale Name des neuen Knotens.

namespaceURI: String

Der Namespace-URI des neuen Knotens.

Gibt zurück

XmlNode

Die neue XmlNode.

Ausnahmen

ArgumentException

Der Name wurde nicht bereitgestellt, und XmlNodeType erfordert einen Namen.

Beispiele

Im folgenden Beispiel wird dem Dokument ein neues Element hinzugefügt.

#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

In der folgenden Tabelle wird gezeigt, welche NodeType[zeile] innerhalb eines anderen NodeType[column] gemäß der Empfehlung von W3C Extensible Markup Language (XML) 1.0 zulässig ist.

	Dokument	DocumentType	XmlDeclaration	Element	attribute	Text	CDATA	Markup	EntityReference
`Document`	nein	nein	nein	nein	nein	nein	nein	nein	nein
`DocumentType`	ja	nein	nein	nein	nein	nein	nein	nein	nein
`XmlDeclaration`	Ja*	nein	nein	nein	nein	nein	nein	nein	nein
`Element`	ja	nein	nein	ja	nein	nein	nein	nein	Ja***
`Attribute`	nein	nein	nein	Ja****	nein	nein	nein	nein	nein
`Text`	nein	nein	nein	ja	ja	nein	nein	nein	ja
`CDATA`	nein	nein	nein	ja	nein	nein	nein	nein	Ja***
`Markup**`	ja	nein	nein	ja	nein	nein	nein	nein	nein
`EntityReference`	nein	nein	nein	ja	ja	nein	nein	nein	ja

* Der XmlDeclaration-Knoten muss das erste untergeordnete Element des Dokumentknotens sein.

** Markup umfasst ProcessingInstruction und Kommentarknoten.

Elemente und CDATA-Knoten sind nur in EntityReference-Knoten zulässig, wenn der EntityReference-Knoten kein untergeordnetes Element eines Attributknotens ist.

Attribute sind keine untergeordneten Elemente eines Elementknotens. Attribute sind in einer Attributauflistung enthalten, die zum Elementknoten gehört.

Diese Methode ist eine Microsoft-Erweiterung für das Dokumentobjektmodell (DOM).

Gilt für

XmlDocument.CreateNode Methode

Definition

Überlädt

CreateNode(String, String, String)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Gilt für

CreateNode(XmlNodeType, String, String)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Gilt für

CreateNode(XmlNodeType, String, String, String)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Gilt für

Zusätzliche Ressourcen