XmlDocument.CreateNode XmlDocument.CreateNode XmlDocument.CreateNode XmlDocument.CreateNode Method

정의

XmlNode를 만듭니다.Creates an XmlNode.

오버로드

CreateNode(String, String, String) CreateNode(String, String, String) CreateNode(String, String, String) CreateNode(String, String, String)

지정된 노드 형식, NameNamespaceURI가 있는 XmlNode를 만듭니다.Creates an XmlNode with the specified node type, Name, and NamespaceURI.

CreateNode(XmlNodeType, String, String) CreateNode(XmlNodeType, String, String) CreateNode(XmlNodeType, String, String) CreateNode(XmlNodeType, String, String)

지정된 XmlNodeType, NameNamespaceURI가 있는 XmlNode를 만듭니다.Creates an XmlNode with the specified XmlNodeType, Name, and NamespaceURI.

CreateNode(XmlNodeType, String, String, String) CreateNode(XmlNodeType, String, String, String) CreateNode(XmlNodeType, String, String, String) CreateNode(XmlNodeType, String, String, String)

지정된 XmlNodeType, Prefix, NameNamespaceURI가 있는 XmlNode를 만듭니다.Creates a XmlNode with the specified XmlNodeType, Prefix, Name, and NamespaceURI.

CreateNode(String, String, String) CreateNode(String, String, String) CreateNode(String, String, String) CreateNode(String, String, String)

지정된 노드 형식, NameNamespaceURI가 있는 XmlNode를 만듭니다.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 String String 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 String String String

새 노드의 정규화된 이름입니다.The qualified name of the new node. 이름에 콜론이 포함된 경우에는 PrefixLocalName 구성 요소로 구문 분석됩니다.If the name contains a colon, it is parsed into Prefix and LocalName components.

namespaceURI
String String String 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 XmlNodeTypeXmlNodeType
특성attribute 특성Attribute
cdatasectioncdatasection CDATACDATA
commentcomment 주석Comment
문서document 문서Document
documentfragmentdocumentfragment DocumentFragmentDocumentFragment
documenttypedocumenttype DocumentTypeDocumentType
요소element 요소Element
entityreferenceentityreference EntityReferenceEntityReference
processinginstructionprocessinginstruction ProcessingInstructionProcessingInstruction
significantwhitespacesignificantwhitespace SignificantWhitespaceSignificantWhitespace
텍스트text 텍스트Text
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.

다음 표에서는 W3C XML(Extensible Markup Language) (XML) 1.0 권장 사항에 따라 다른 nodetype [column] 내에서 허용 되는 nodetype [row]를 보여 줍니다.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.

문서Document DocumentTypeDocumentType XmlDeclarationXmlDeclaration 요소Element 특성Attribute 텍스트Text CDATACDATA 태그Markup EntityReferenceEntityReference
Document nono nono nono nono nono nono nono nono nono
DocumentType yes nono nono nono nono nono nono nono nono
XmlDeclaration 예 *yes* nono nono nono nono nono nono nono nono
Element yes nono nono yes nono nono nono nono 예 * * *yes***
Attribute nono nono nono 예 * * *yes**** nono nono nono nono nono
Text nono nono nono yes yes nono nono nono yes
CDATA nono nono nono yes nono nono nono nono 예 * * *yes***
Markup** yes nono nono yes nono nono nono nono nono
EntityReference nono nono nono yes yes nono nono nono yes

* XmlDeclaration 노드는 문서 노드의 첫 번째 자식 이어야 합니다.* The XmlDeclaration node must be the first child of the Document node.

* * 태그 ProcessingInstruction 및 주석 노드를 포함합니다.** Markup includes ProcessingInstruction and Comment nodes.

요소 및 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.

특성은 요소 노드의 자식은 아닙니다.**** Attributes are not children of an Element node. 특성은 특성 컬렉션에 있는 요소 노드에 속하는 안에 포함 됩니다.Attributes are contained inside an attribute collection that belongs to an Element node.

이 메서드는 문서 개체 모델 (DOM)에 대 한 Microsoft 확장입니다.This method is a Microsoft extension to the Document Object Model (DOM).

CreateNode(XmlNodeType, String, String) CreateNode(XmlNodeType, String, String) CreateNode(XmlNodeType, String, String) CreateNode(XmlNodeType, String, String)

지정된 XmlNodeType, NameNamespaceURI가 있는 XmlNode를 만듭니다.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 XmlNodeType XmlNodeType

새 노드의 XmlNodeType입니다.The XmlNodeType of the new node.

name
String String String String

새 노드의 정규화된 이름입니다.The qualified name of the new node. 이름에 콜론이 포함되어 있으면 PrefixLocalName 구성 요소로 구문 분석됩니다.If the name contains a colon then it is parsed into Prefix and LocalName components.

namespaceURI
String String String 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.

다음 표에서는 W3C XML(Extensible Markup Language) (XML) 1.0 권장 사항에 따라 다른 nodetype [column] 내에서 허용 되는 nodetype [row]를 보여 줍니다.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.

문서Document DocumentTypeDocumentType XmlDeclarationXmlDeclaration 요소Element 특성Attribute 텍스트Text CDATACDATA 태그Markup EntityReferenceEntityReference
Document nono nono nono nono nono nono nono nono nono
DocumentType yes nono nono nono nono nono nono nono nono
XmlDeclaration 예 *yes* nono nono nono nono nono nono nono nono
Element yes nono nono yes nono nono nono nono 예 * * *yes***
Attribute nono nono nono 예 * * *yes**** nono nono nono nono nono
Text nono nono nono yes yes nono nono nono yes
CDATA nono nono nono yes nono nono nono nono 예 * * *yes***
Markup** yes nono nono yes nono nono nono nono nono
EntityReference nono nono nono yes yes nono nono nono yes

* XmlDeclaration 노드는 문서 노드의 첫 번째 자식 이어야 합니다.* The XmlDeclaration node must be the first child of the Document node.

* * 태그 ProcessingInstruction 및 주석 노드를 포함합니다.** Markup includes ProcessingInstruction and Comment nodes.

요소 및 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.

특성은 요소 노드의 자식은 아닙니다.**** Attributes are not children of an Element node. 특성은 특성 컬렉션에 있는 요소 노드에 속하는 안에 포함 됩니다.Attributes are contained inside an attribute collection that belongs to an Element node.

이 메서드는 문서 개체 모델 (DOM)에 대 한 Microsoft 확장입니다.This method is a Microsoft extension to the Document Object Model (DOM).

CreateNode(XmlNodeType, String, String, String) CreateNode(XmlNodeType, String, String, String) CreateNode(XmlNodeType, String, String, String) CreateNode(XmlNodeType, String, String, String)

지정된 XmlNodeType, Prefix, NameNamespaceURI가 있는 XmlNode를 만듭니다.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 XmlNodeType XmlNodeType

새 노드의 XmlNodeType입니다.The XmlNodeType of the new node.

prefix
String String String String

새 노드의 접두사입니다.The prefix of the new node.

name
String String String String

새 노드의 지역 이름입니다.The local name of the new node.

namespaceURI
String String String 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.

다음 표에서는 W3C XML(Extensible Markup Language) (XML) 1.0 권장 사항에 따라 다른 nodetype [column] 내에서 허용 되는 nodetype [row]를 보여 줍니다.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.

문서Document DocumentTypeDocumentType XmlDeclarationXmlDeclaration 요소Element 특성Attribute 텍스트Text CDATACDATA 태그Markup EntityReferenceEntityReference
Document nono nono nono nono nono nono nono nono nono
DocumentType yes nono nono nono nono nono nono nono nono
XmlDeclaration 예 *yes* nono nono nono nono nono nono nono nono
Element yes nono nono yes nono nono nono nono 예 * * *yes***
Attribute nono nono nono 예 * * *yes**** nono nono nono nono nono
Text nono nono nono yes yes nono nono nono yes
CDATA nono nono nono yes nono nono nono nono 예 * * *yes***
Markup** yes nono nono yes nono nono nono nono nono
EntityReference nono nono nono yes yes nono nono nono yes

* XmlDeclaration 노드는 문서 노드의 첫 번째 자식 이어야 합니다.* The XmlDeclaration node must be the first child of the Document node.

* * 태그 ProcessingInstruction 및 주석 노드를 포함합니다.** Markup includes ProcessingInstruction and Comment nodes.

요소 및 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.

특성은 요소 노드의 자식은 아닙니다.**** Attributes are not children of an Element node. 특성은 요소 노드에 속하는 특성 컬렉션 안에 포함 됩니다.Attributes are contained inside an attribute collection that belongs to the Element node.

이 메서드는 문서 개체 모델 (DOM)에 대 한 Microsoft 확장입니다.This method is a Microsoft extension to the Document Object Model (DOM).

적용 대상