XmlDocument.CreateNode Метод

Определение

Создает XmlNode.Creates an XmlNode.

Перегрузки

CreateNode(String, String, String)

Создает XmlNode с помощью указанного типа узла, а также свойств Name и NamespaceURI.Creates an XmlNode with the specified node type, Name, and NamespaceURI.

CreateNode(XmlNodeType, String, String)

Создает объект XmlNode с помощью указанных значений XmlNodeType, Name и NamespaceURI.Creates an XmlNode with the specified XmlNodeType, Name, and NamespaceURI.

CreateNode(XmlNodeType, String, String, String)

Создает объект XmlNode с помощью указанных типов XmlNodeType, Prefix, Name и NamespaceURI.Creates a XmlNode with the specified XmlNodeType, Prefix, Name, and NamespaceURI.

CreateNode(String, String, String)

Создает XmlNode с помощью указанного типа узла, а также свойств Name и 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

Параметры

nodeTypeString
String

Строковая версия типа XmlNodeType нового узла.String version of the XmlNodeType of the new node. Этот параметр должен принимать одно из значений, перечисленных в следующей таблице.This parameter must be one of the values listed in the table below.

name
String

Полное имя нового узла.The qualified name of the new node. Если имя содержит двоеточие, оно разбивается на компоненты Prefix и LocalName.If the name contains a colon, it is parsed into Prefix and LocalName components.

namespaceURI
String

URI пространства имен нового узла.The namespace URI of the new node.

Возвраты

Новый объект XmlNode.The new XmlNode.

Исключения

Имя не указано, а XmlNodeType требуется имя; или строка nodeTypeString не является одной из следующих строк.The name was not provided and the XmlNodeType requires a name; or nodeTypeString is not one of the strings listed below.

Примеры

В следующем примере создается новый элемент и вставляется в документ.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

Комментарии

nodeTypeString Параметр учитывает регистр и должен быть одним из значений, приведенных в следующей таблице.The nodeTypeString parameter is case sensitive and must be one of the values in the following table.

nodeTypeStringnodeTypeString Тип узла XMLXmlNodeType
Атрибутattribute АтрибутAttribute
кдатасектионcdatasection CDATACDATA
комментарийcomment КомментарийComment
документdocument DocumentDocument
DocumentFragmentdocumentfragment DocumentFragmentDocumentFragment
DocumentTypedocumenttype DocumentType;DocumentType
элементelement ЭлементElement
Ссылкаentityreference EntityReferenceEntityReference
процессингинструктионprocessinginstruction ProcessingInstruction;ProcessingInstruction
сигнификантвхитеспацеsignificantwhitespace SignificantWhitespaceSignificantWhitespace
текстtext TextText
whitespacewhitespace WhitespaceWhitespace

Несмотря на то, что этот метод создает новый объект в контексте документа, он не добавляет новый объект автоматически в дерево документов.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. Чтобы добавить новый объект, необходимо явным образом вызвать один из методов вставки узла.To add the new object, you must explicitly call one of the node insert methods.

В следующей таблице показано, что параметр NodeType [Row] разрешен внутри другого типа данных NodeType [Column] согласно рекомендации консорциума W3C язык XML (XML) 1,0.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.

DocumentDocument DocumentType;DocumentType XmlDeclarationXmlDeclaration ЭлементElement АтрибутAttribute TextText CDATACDATA разметкуMarkup EntityReferenceEntityReference
Document Нетno Нетno Нетno Нетno Нетno Нетno Нетno Нетno Нетno
DocumentType даyes Нетno Нетno Нетno Нетno Нетno Нетno Нетno Нетno
XmlDeclaration Даyes* Нетno Нетno Нетno Нетno Нетno Нетno Нетno Нетno
Element даyes Нетno Нетno даyes Нетno Нетno Нетno Нетno Да * * *yes***
Attribute Нетno Нетno Нетno Да * * * *yes**** Нетno Нетno Нетno Нетno Нетno
Text Нетno Нетno Нетno даyes даyes Нетno Нетno Нетno даyes
CDATA Нетno Нетno Нетno даyes Нетno Нетno Нетno Нетno Да * * *yes***
Markup** даyes Нетno Нетno даyes Нетno Нетno Нетno Нетno Нетno
EntityReference Нетno Нетno Нетno даyes даyes Нетno Нетno Нетno даyes

*Узел XmlDeclaration должен быть первым дочерним элементом узла документа.* The XmlDeclaration node must be the first child of the Document node.

* * Разметка включает узлы Процессингинструктион и Comment.** Markup includes ProcessingInstruction and Comment nodes.

Узлы Element и CDATA разрешены только в узлах EntityReference, если узел EntityReference не является дочерним по отношению к узлу атрибута.*** Element and CDATA nodes are only allowed in EntityReference nodes when the EntityReference node is not a child of an Attribute node.

Атрибуты не являются дочерними элементами узла Element.**** Attributes are not children of an Element node. Атрибуты содержатся внутри коллекции атрибутов, принадлежащей узлу element.Attributes are contained inside an attribute collection that belongs to an Element node.

Этот метод является расширением Майкрософт для модель DOM (DOM).This method is a Microsoft extension to the Document Object Model (DOM).

CreateNode(XmlNodeType, String, String)

Создает объект XmlNode с помощью указанных значений XmlNodeType, Name и 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

Параметры

type
XmlNodeType

Тип XmlNodeType нового узла.The XmlNodeType of the new node.

name
String

Полное имя нового узла.The qualified name of the new node. Если имя содержит двоеточие, оно разбивается на компоненты Prefix и LocalName.If the name contains a colon then it is parsed into Prefix and LocalName components.

namespaceURI
String

URI пространства имен нового узла.The namespace URI of the new node.

Возвраты

Новый объект XmlNode.The new XmlNode.

Исключения

Имя не указано, а для XmlNodeType требуется имя.The name was not provided and the XmlNodeType requires a name.

Примеры

В следующем примере создается новый элемент и вставляется в XML-документ.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

Комментарии

Несмотря на то, что этот метод создает новый объект в контексте документа, он не добавляет новый объект автоматически в дерево документов.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. Чтобы добавить новый объект, необходимо явным образом вызвать один из методов вставки узла.To add the new object, you must explicitly call one of the node insert methods.

В следующей таблице показано, что параметр NodeType [Row] разрешен внутри другого типа данных NodeType [Column] согласно рекомендации консорциума W3C язык XML (XML) 1,0.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.

DocumentDocument DocumentType;DocumentType XmlDeclarationXmlDeclaration ЭлементElement АтрибутAttribute TextText CDATACDATA разметкуMarkup EntityReferenceEntityReference
Document Нетno Нетno Нетno Нетno Нетno Нетno Нетno Нетno Нетno
DocumentType даyes Нетno Нетno Нетno Нетno Нетno Нетno Нетno Нетno
XmlDeclaration Даyes* Нетno Нетno Нетno Нетno Нетno Нетno Нетno Нетno
Element даyes Нетno Нетno даyes Нетno Нетno Нетno Нетno Да * * *yes***
Attribute Нетno Нетno Нетno Да * * * *yes**** Нетno Нетno Нетno Нетno Нетno
Text Нетno Нетno Нетno даyes даyes Нетno Нетno Нетno даyes
CDATA Нетno Нетno Нетno даyes Нетno Нетno Нетno Нетno Да * * *yes***
Markup** даyes Нетno Нетno даyes Нетno Нетno Нетno Нетno Нетno
EntityReference Нетno Нетno Нетno даyes даyes Нетno Нетno Нетno даyes

*Узел XmlDeclaration должен быть первым дочерним элементом узла документа.* The XmlDeclaration node must be the first child of the Document node.

* * Разметка включает узлы Процессингинструктион и Comment.** Markup includes ProcessingInstruction and Comment nodes.

Узлы Element и CDATA разрешены только в узлах EntityReference, если узел EntityReference не является дочерним по отношению к узлу атрибута.*** Element and CDATA nodes are only allowed in EntityReference nodes when the EntityReference node is not a child of an Attribute node.

Атрибуты не являются дочерними элементами узла Element.**** Attributes are not children of an Element node. Атрибуты содержатся внутри коллекции атрибутов, принадлежащей узлу element.Attributes are contained inside an attribute collection that belongs to an Element node.

Этот метод является расширением Майкрософт для модель DOM (DOM).This method is a Microsoft extension to the Document Object Model (DOM).

CreateNode(XmlNodeType, String, String, String)

Создает объект XmlNode с помощью указанных типов XmlNodeType, Prefix, Name и 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

Параметры

type
XmlNodeType

Тип XmlNodeType нового узла.The XmlNodeType of the new node.

prefix
String

Префикс нового узла.The prefix of the new node.

name
String

Локальное имя нового узла.The local name of the new node.

namespaceURI
String

URI пространства имен нового узла.The namespace URI of the new node.

Возвраты

Новый объект XmlNode.The new XmlNode.

Исключения

Имя не указано, а для XmlNodeType требуется имя.The name was not provided and the XmlNodeType requires a name.

Примеры

В следующем примере в документ добавляется новый элемент.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

Комментарии

Несмотря на то, что этот метод создает новый объект в контексте документа, он не добавляет новый объект автоматически в дерево документов.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. Чтобы добавить новый объект, необходимо явным образом вызвать один из методов вставки узла.To add the new object, you must explicitly call one of the node insert methods.

В следующей таблице показано, что параметр NodeType [Row] разрешен внутри другого типа данных NodeType [Column] согласно рекомендации консорциума W3C язык XML (XML) 1,0.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.

DocumentDocument DocumentType;DocumentType XmlDeclarationXmlDeclaration ЭлементElement АтрибутAttribute TextText CDATACDATA разметкуMarkup EntityReferenceEntityReference
Document Нетno Нетno Нетno Нетno Нетno Нетno Нетno Нетno Нетno
DocumentType даyes Нетno Нетno Нетno Нетno Нетno Нетno Нетno Нетno
XmlDeclaration Даyes* Нетno Нетno Нетno Нетno Нетno Нетno Нетno Нетno
Element даyes Нетno Нетno даyes Нетno Нетno Нетno Нетno Да * * *yes***
Attribute Нетno Нетno Нетno Да * * * *yes**** Нетno Нетno Нетno Нетno Нетno
Text Нетno Нетno Нетno даyes даyes Нетno Нетno Нетno даyes
CDATA Нетno Нетno Нетno даyes Нетno Нетno Нетno Нетno Да * * *yes***
Markup** даyes Нетno Нетno даyes Нетno Нетno Нетno Нетno Нетno
EntityReference Нетno Нетno Нетno даyes даyes Нетno Нетno Нетno даyes

*Узел XmlDeclaration должен быть первым дочерним элементом узла документа.* The XmlDeclaration node must be the first child of the Document node.

* * Разметка включает узлы Процессингинструктион и Comment.** Markup includes ProcessingInstruction and Comment nodes.

Узлы Element и CDATA разрешены только в узлах EntityReference, если узел EntityReference не является дочерним по отношению к узлу атрибута.*** Element and CDATA nodes are only allowed in EntityReference nodes when the EntityReference node is not a child of an Attribute node.

Атрибуты не являются дочерними элементами узла Element.**** Attributes are not children of an Element node. Атрибуты содержатся внутри коллекции атрибутов, принадлежащей узлу element.Attributes are contained inside an attribute collection that belongs to the Element node.

Этот метод является расширением Майкрософт для модель DOM (DOM).This method is a Microsoft extension to the Document Object Model (DOM).

Применяется к