XmlDocument.CreateNode Yöntem

Tanım

Ad Alanı:: System.Xml

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

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

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

Bütünleştirilmiş Kod:: System.Xml.ReaderWriter.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.

bir XmlNodeoluşturur.

Aşırı Yüklemeler

Name	Description
CreateNode(String, String, String)	Belirtilen düğüm türü olan , XmlNodeve Nameile bir NamespaceURI oluşturur.
CreateNode(XmlNodeType, String, String)	Belirtilen XmlNode, XmlNodeTypeve Nameile bir NamespaceURI oluşturur.
CreateNode(XmlNodeType, String, String, String)	Belirtilen XmlNode, , XmlNodeType Prefixve Nameile bir NamespaceURI oluşturur.

CreateNode(String, String, String)

Kaynak:: XmlDocument.cs

Kaynak:: XmlDocument.cs

Kaynak:: XmlDocument.cs

Kaynak:: XmlDocument.cs

Kaynak:: XmlDocument.cs

Belirtilen düğüm türü olan , XmlNodeve Nameile bir NamespaceURI 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 Prefix bileşenlerine LocalName 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 gerektirir; veya nodeTypeString aşağıda listelenen dizelerden biri değildir.

Örnekler

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

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
Öznitelik	Attribute
cdatasection	CDATA
yorum	Yorum
belge	Belge
Documentfragment	Documentfragment
documenttype	BelgeTürü
öğesi	Öğe
Entityreference	EntityReference
Processingınstruction	İşlem Talimatı
significantwhitespace	Önemli Boşluk
text	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[column] içinde hangi NodeType[satır] öğesine izin verileceğini görebilirsiniz.

Düğüm türü	Belge	BelgeTürü	XML Bildirimi	Öğe	Attribute	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†
`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†
`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

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

§ Markup ve düğümlerini içerir ProcessingInstructionComment .

Element† ve CDATA düğümlere yalnızca düğüm bir EntityReference düğümün EntityReference alt öğesi olmadığında düğümlerde Attribute izin verilir.

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

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

Şunlara uygulanır

CreateNode(XmlNodeType, String, String)

Kaynak:: XmlDocument.cs

Kaynak:: XmlDocument.cs

Kaynak:: XmlDocument.cs

Kaynak:: XmlDocument.cs

Kaynak:: XmlDocument.cs

Belirtilen XmlNode, XmlNodeTypeve Nameile bir NamespaceURI 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.

name: String

Yeni düğümün tam adı. Ad iki nokta üst üste içeriyorsa ve Prefix bileşenlerine LocalName 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;
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örebilirsiniz.

Düğüm türü	Belge	BelgeTürü	XML Bildirimi	Öğe	Attribute	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†
`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†
`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

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

§ Markup ve düğümlerini içerir ProcessingInstructionComment .

Element† ve CDATA düğümlere yalnızca düğüm bir EntityReference düğümün EntityReference alt öğesi olmadığında düğümlerde Attribute izin verilir.

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

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

Şunlara uygulanır

CreateNode(XmlNodeType, String, String, String)

Kaynak:: XmlDocument.cs

Kaynak:: XmlDocument.cs

Kaynak:: XmlDocument.cs

Kaynak:: XmlDocument.cs

Kaynak:: XmlDocument.cs

Belirtilen XmlNode, , XmlNodeType Prefixve Nameile bir NamespaceURI 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.

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;
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örebilirsiniz.

	Belge	BelgeTürü	XML Bildirimi	Öğe	Attribute	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†
`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†
`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.

§ Markup ve düğümlerini içerir ProcessingInstructionComment .

Element† ve CDATA düğümlere yalnızca düğüm bir EntityReference düğümün EntityReference alt öğesi olmadığında düğümlerde Attribute izin verilir.

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

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

Şunlara uygulanır

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?