XmlDocument.CreateNode Yöntem

Başvuru

Tanım

Ad Alanı:: System.Xml

Bütünleştirilmiş Kodlar:: System.Xml.dll, System.Xml.XmlDocument.dll

Bütünleştirilmiş Kod:: System.Xml.ReaderWriter.dll

Bütünleştirilmiş Kod:: System.Xml.XmlDocument.dll

Bütünleştirilmiş Kod:: System.Xml.dll

Bütünleştirilmiş Kod:: netstandard.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

oluşturur XmlNode.

Aşırı Yüklemeler

CreateNode(String, String, String)	Belirtilen düğüm türü Name, ve NamespaceURIile bir XmlNode oluşturur.
CreateNode(XmlNodeType, String, String)	Belirtilen XmlNodeType, Nameve NamespaceURIile bir XmlNode oluşturur.
CreateNode(XmlNodeType, String, String, String)	Belirtilen XmlNodeType, , Prefix Nameve NamespaceURIile bir XmlNode oluşturur.

CreateNode(String, String, String)

Belirtilen düğüm türü Name, ve NamespaceURIile bir XmlNode oluşturur.

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

Parametreler

nodeTypeString: String

Yeni düğümün XmlNodeType dize sürümü. Bu parametre aşağıdaki tabloda listelenen değerlerden biri olmalıdır.

name: String

Yeni düğümün tam adı. Ad iki nokta üst üste içeriyorsa ve LocalName bileşenlerine Prefix ayrıştırılır.

namespaceURI: String

Yeni düğümün ad alanı URI'si.

Döndürülenler

XmlNode

Yeni XmlNode.

Özel durumlar

ArgumentException

Ad sağlanmadı ve XmlNodeType adı gerekiyor veya nodeTypeString aşağıda listelenen dizelerden biri değil.

Örnekler

Aşağıdaki örnek yeni bir öğe oluşturur ve belgeye ekler.

#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

Açıklamalar

nodeTypeString parametresi büyük/küçük harfe duyarlıdır ve aşağıdaki tabloda yer alan değerlerden biri olmalıdır.

nodeTypeString	Xmlnodetype
özniteliği	Öznitelik
cdatasection	CDATA
comment	Yorum
belge	Belge
Documentfragment	Documentfragment
Documenttype	Documenttype
öğesi	Öğe
Entityreference	EntityReference
Processingınstruction	Processingınstruction
significantwhitespace	SignificantWhitespace
metin	Metin
Boşluk	Boşluk

Bu yöntem yeni nesneyi belge bağlamında oluştursa da, yeni nesneyi belge ağacına otomatik olarak eklemez. Yeni nesneyi eklemek için düğüm ekleme yöntemlerinden birini açıkça çağırmanız gerekir.

Aşağıdaki tabloda, W3C Genişletilebilir Biçimlendirme Dili (XML) 1.0 önerisine göre başka bir NodeType[sütun] içinde hangi NodeType[satır] öğesine izin verileceğini gösterilmektedir.

	Belge	Documenttype	Xmldeclaration	Öğe	Öznitelik	Metin	CDATA	İşaretleme	EntityReference
`Document`	hayır	hayır	hayır	hayır	hayır	hayır	hayır	hayır	hayır
`DocumentType`	evet	hayır	hayır	hayır	hayır	hayır	hayır	hayır	hayır
`XmlDeclaration`	Evet*	hayır	hayır	hayır	hayır	hayır	hayır	hayır	hayır
`Element`	evet	hayır	hayır	evet	hayır	hayır	hayır	hayır	Evet, evet.
`Attribute`	hayır	hayır	hayır	Evet****	hayır	hayır	hayır	hayır	hayır
`Text`	hayır	hayır	hayır	evet	evet	hayır	hayır	hayır	evet
`CDATA`	hayır	hayır	hayır	evet	hayır	hayır	hayır	hayır	Evet, evet.
`Markup**`	evet	hayır	hayır	evet	hayır	hayır	hayır	hayır	hayır
`EntityReference`	hayır	hayır	hayır	evet	evet	hayır	hayır	hayır	evet

* XmlDeclaration düğümü, Belge düğümünün ilk alt öğesi olmalıdır.

** İşaretleme, ProcessingInstruction ve Comment düğümlerini içerir.

Öğe ve CDATA düğümlerine yalnızca EntityReference düğümü bir Öznitelik düğümünün alt öğesi olmadığında EntityReference düğümlerinde izin verilir.

Öznitelikler bir Öğe düğümünün alt öğeleri değildir. Öznitelikler, bir Öğe düğümüne ait öznitelik koleksiyonunun içinde yer alır.

Bu yöntem, Belge Nesne Modeli'nin (DOM) Bir Microsoft uzantısıdır.

Şunlara uygulanır

.NET 7 ve diğer sürümler

Ürün	Sürümler
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard	2.0, 2.1
UWP	10.0

CreateNode(XmlNodeType, String, String)

Belirtilen XmlNodeType, Nameve NamespaceURIile bir XmlNode oluşturur.

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

Parametreler

type: XmlNodeType

XmlNodeType Yeni düğümün sayısı.

name: String

Yeni düğümün tam adı. Ad iki nokta üst üste içeriyorsa ve LocalName bileşenlerine Prefix ayrıştırılır.

namespaceURI: String

Yeni düğümün ad alanı URI'si.

Döndürülenler

XmlNode

Yeni XmlNode.

Özel durumlar

ArgumentException

Ad sağlanmadı ve XmlNodeType bir ad gerektiriyor.

Örnekler

Aşağıdaki örnek yeni bir öğe oluşturur ve bir XML belgesine ekler.

#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

Açıklamalar

Aşağıdaki tabloda, W3C Genişletilebilir Biçimlendirme Dili (XML) 1.0 önerisine göre başka bir NodeType[column] içinde hangi NodeType[satır] öğesine izin verileceğini gösterilmektedir.

	Belge	Documenttype	Xmldeclaration	Öğe	Öznitelik	Metin	CDATA	İşaretleme	EntityReference
`Document`	hayır	hayır	hayır	hayır	hayır	hayır	hayır	hayır	hayır
`DocumentType`	evet	hayır	hayır	hayır	hayır	hayır	hayır	hayır	hayır
`XmlDeclaration`	Evet*	hayır	hayır	hayır	hayır	hayır	hayır	hayır	hayır
`Element`	evet	hayır	hayır	evet	hayır	hayır	hayır	hayır	Evet, evet.
`Attribute`	hayır	hayır	hayır	Evet****	hayır	hayır	hayır	hayır	hayır
`Text`	hayır	hayır	hayır	evet	evet	hayır	hayır	hayır	evet
`CDATA`	hayır	hayır	hayır	evet	hayır	hayır	hayır	hayır	Evet, evet.
`Markup**`	evet	hayır	hayır	evet	hayır	hayır	hayır	hayır	hayır
`EntityReference`	hayır	hayır	hayır	evet	evet	hayır	hayır	hayır	evet

* XmlDeclaration düğümü, Belge düğümünün ilk alt öğesi olmalıdır.

** İşaretleme, ProcessingInstruction ve Comment düğümlerini içerir.

Öğe ve CDATA düğümlerine yalnızca EntityReference düğümü bir Öznitelik düğümünün alt öğesi olmadığında EntityReference düğümlerinde izin verilir.

Öznitelikler bir Öğe düğümünün alt öğeleri değildir. Öznitelikler, bir Öğe düğümüne ait öznitelik koleksiyonunun içinde yer alır.

Bu yöntem, Belge Nesne Modeli'nin (DOM) Bir Microsoft uzantısıdır.

Şunlara uygulanır

.NET 7 ve diğer sürümler

Ürün	Sürümler
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard	2.0, 2.1
UWP	10.0

CreateNode(XmlNodeType, String, String, String)

Belirtilen XmlNodeType, , Prefix Nameve NamespaceURIile bir XmlNode oluşturur.

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

Parametreler

type: XmlNodeType

XmlNodeType Yeni düğümün sayısı.

prefix: String

Yeni düğümün ön eki.

name: String

Yeni düğümün yerel adı.

namespaceURI: String

Yeni düğümün ad alanı URI'si.

Döndürülenler

XmlNode

Yeni XmlNode.

Özel durumlar

ArgumentException

Ad sağlanmadı ve XmlNodeType bir ad gerektiriyor.

Örnekler

Aşağıdaki örnek belgeye yeni bir öğe ekler.

#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

Açıklamalar

Aşağıdaki tabloda, W3C Genişletilebilir Biçimlendirme Dili (XML) 1.0 önerisine göre başka bir NodeType[column] içinde hangi NodeType[satır] öğesine izin verileceğini gösterilmektedir.

	Belge	Documenttype	Xmldeclaration	Öğe	Öznitelik	Metin	CDATA	İşaretleme	EntityReference
`Document`	hayır	hayır	hayır	hayır	hayır	hayır	hayır	hayır	hayır
`DocumentType`	evet	hayır	hayır	hayır	hayır	hayır	hayır	hayır	hayır
`XmlDeclaration`	Evet*	hayır	hayır	hayır	hayır	hayır	hayır	hayır	hayır
`Element`	evet	hayır	hayır	evet	hayır	hayır	hayır	hayır	Evet, evet.
`Attribute`	hayır	hayır	hayır	Evet****	hayır	hayır	hayır	hayır	hayır
`Text`	hayır	hayır	hayır	evet	evet	hayır	hayır	hayır	evet
`CDATA`	hayır	hayır	hayır	evet	hayır	hayır	hayır	hayır	Evet, evet.
`Markup**`	evet	hayır	hayır	evet	hayır	hayır	hayır	hayır	hayır
`EntityReference`	hayır	hayır	hayır	evet	evet	hayır	hayır	hayır	evet

* XmlDeclaration düğümü, Belge düğümünün ilk alt öğesi olmalıdır.

** İşaretleme, ProcessingInstruction ve Comment düğümlerini içerir.

Öğe ve CDATA düğümlerine yalnızca EntityReference düğümü bir Öznitelik düğümünün alt öğesi olmadığında EntityReference düğümlerinde izin verilir.

Öznitelikler bir Öğe düğümünün alt öğeleri değildir. Öznitelikler, Öğe düğümüne ait bir öznitelik koleksiyonunun içinde yer alır.

Bu yöntem, Belge Nesne Modeli'nin (DOM) Bir Microsoft uzantısıdır.

Şunlara uygulanır

.NET 7 ve diğer sürümler

Ürün	Sürümler
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard	2.0, 2.1
UWP	10.0

Aracılığıyla paylaş

XmlDocument.CreateNode Yöntem

Tanım

Aşırı Yüklemeler

CreateNode(String, String, String)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Şunlara uygulanır

CreateNode(XmlNodeType, String, String)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Şunlara uygulanır

CreateNode(XmlNodeType, String, String, String)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Şunlara uygulanır

Ek kaynaklar