Aracılığıyla paylaş


XmlDocument.CreateNode Yöntem

Tanım

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, , PrefixNameve 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

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

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

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

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ö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

CreateNode(XmlNodeType, String, String, String)

Belirtilen XmlNodeType, , PrefixNameve 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

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

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ö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