XmlDocument.CreateElement XmlDocument.CreateElement XmlDocument.CreateElement XmlDocument.CreateElement Method

정의

XmlElement를 만듭니다.Creates an XmlElement.

오버로드

CreateElement(String) CreateElement(String) CreateElement(String) CreateElement(String)

지정된 이름을 가진 요소를 만듭니다.Creates an element with the specified name.

CreateElement(String, String) CreateElement(String, String) CreateElement(String, String) CreateElement(String, String)

정규화된 이름과 NamespaceURI를 가진 XmlElement를 만듭니다.Creates an XmlElement with the qualified name and NamespaceURI.

CreateElement(String, String, String) CreateElement(String, String, String) CreateElement(String, String, String) CreateElement(String, String, String)

지정된 Prefix, LocalNameNamespaceURI가 있는 요소를 만듭니다.Creates an element with the specified Prefix, LocalName, and NamespaceURI.

CreateElement(String) CreateElement(String) CreateElement(String) CreateElement(String)

지정된 이름을 가진 요소를 만듭니다.Creates an element with the specified name.

public:
 System::Xml::XmlElement ^ CreateElement(System::String ^ name);
public System.Xml.XmlElement CreateElement (string name);
member this.CreateElement : string -> System.Xml.XmlElement
Public Function CreateElement (name As String) As XmlElement

매개 변수

name
String String String String

요소의 정규화된 이름입니다.The qualified name of the element. 이름에 콜론이 포함되어 있는 경우 Prefix 속성은 콜론 앞의 이름 부분을 반영하고 LocalName 속성은 콜론 뒤의 이름 부분을 반영합니다.If the name contains a colon then the Prefix property reflects the part of the name preceding the colon and the LocalName property reflects the part of the name after the colon. 정규화된 이름에는 'xmlns'라는 접두사가 포함될 수 없습니다.The qualified name cannot include a prefix of 'xmlns'.

반환

XmlElement입니다.The new XmlElement.

예제

다음 예제에서는 새 요소를 만들고 문서에 추가 합니다.The following example creates a new element and adds it to the 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.
   //The text node is the content of the price element.
   XmlElement^ elem = doc->CreateElement( "price" );
   XmlText^ text = doc->CreateTextNode( "19.95" );
   doc->DocumentElement->AppendChild( elem );
   doc->DocumentElement->LastChild->AppendChild( text );
   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.
    //The text node is the content of the price element.
    XmlElement elem = doc.CreateElement("price");
    XmlText text = doc.CreateTextNode("19.95");
    doc.DocumentElement.AppendChild(elem);
    doc.DocumentElement.LastChild.AppendChild(text);

    Console.WriteLine("Display the modified XML...");
    doc.Save(Console.Out);

  }
}
Option Explicit
Option Strict

Imports System
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.
        'The text node is the content of the price element.
        Dim elem As XmlElement = doc.CreateElement("price")
        Dim text As XmlText = doc.CreateTextNode("19.95")
        doc.DocumentElement.AppendChild(elem)
        doc.DocumentElement.LastChild.AppendChild(text)
        
        Console.WriteLine("Display the modified XML...")
        doc.Save(Console.Out)
    End Sub 'Main 
End Class 'Sample

설명

구현 인스턴스를 반환 합니다 XmlElement 인터페이스를 하므로 기본 특성이 반환 되는 개체에서 직접 만들어집니다.Note that the instance returned implements the XmlElement interface, so default attributes would be created directly on the returned object.

이 메서드가 문서의 컨텍스트에서 새 개체를 만들고, 있지만 추가 되지 않습니다 자동으로 새 개체를 문서 트리에입니다.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에 따라 Extensible Markup Language (XML) 1.0 권장 사항, EntityReference 노드 특성 노드의 자식이 아닙니다. 때 요소 노드는 EntityReference 노드 및 문서 및 요소의 노드 내에 허용 됩니다.According to the W3C Extensible Markup Language (XML) 1.0 recommendation, Element nodes are allowed within Document and Element nodes, and in EntityReference nodes when the EntityReference node is not a child of an Attribute node.

CreateElement(String, String) CreateElement(String, String) CreateElement(String, String) CreateElement(String, String)

정규화된 이름과 NamespaceURI를 가진 XmlElement를 만듭니다.Creates an XmlElement with the qualified name and NamespaceURI.

public:
 System::Xml::XmlElement ^ CreateElement(System::String ^ qualifiedName, System::String ^ namespaceURI);
public System.Xml.XmlElement CreateElement (string qualifiedName, string namespaceURI);
member this.CreateElement : string * string -> System.Xml.XmlElement
Public Function CreateElement (qualifiedName As String, namespaceURI As String) As XmlElement

매개 변수

qualifiedName
String String String String

요소의 정규화된 이름입니다.The qualified name of the element. 이름에 콜론이 포함되어 있는 경우, Prefix 속성은 콜론 앞의 이름 부분을 반영하고 LocalName 속성은 콜론 뒤의 이름 부분을 반영합니다.If the name contains a colon then the Prefix property will reflect the part of the name preceding the colon and the LocalName property will reflect the part of the name after the colon. 정규화된 이름에는 'xmlns'라는 접두사가 포함될 수 없습니다.The qualified name cannot include a prefix of 'xmlns'.

namespaceURI
String String String String

요소의 네임스페이스 URI입니다.The namespace URI of the element.

반환

XmlElement입니다.The new XmlElement.

설명

다음 C# 코드The following C# code

XmlElement elem;  
elem=doc.CreateElement("xy:item", "urn:abc");  

다음 XML 텍스트에 해당 하는 요소에 대 한 결과입니다.results in an element that is equivalent to the following XML text.

<xy:item  
       xmlns:xy="urn:abc"/>  

이 메서드가 문서의 컨텍스트에서 새 개체를 만들고, 있지만 추가 되지 않습니다 자동으로 새 개체를 문서 트리에입니다.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에 따라 Extensible Markup Language (XML) 1.0 권장 사항, EntityReference 노드 특성 노드의 자식이 아닙니다. 때 요소 노드는 EntityReference 노드 및 문서 및 요소의 노드 내에 허용 됩니다.According to the W3C Extensible Markup Language (XML) 1.0 recommendation, Element nodes are allowed within Document and Element nodes, and in EntityReference nodes when the EntityReference node is not a child of an Attribute node.

CreateElement(String, String, String) CreateElement(String, String, String) CreateElement(String, String, String) CreateElement(String, String, String)

지정된 Prefix, LocalNameNamespaceURI가 있는 요소를 만듭니다.Creates an element with the specified Prefix, LocalName, and NamespaceURI.

public:
 virtual System::Xml::XmlElement ^ CreateElement(System::String ^ prefix, System::String ^ localName, System::String ^ namespaceURI);
public virtual System.Xml.XmlElement CreateElement (string prefix, string localName, string namespaceURI);
abstract member CreateElement : string * string * string -> System.Xml.XmlElement
override this.CreateElement : string * string * string -> System.Xml.XmlElement
Public Overridable Function CreateElement (prefix As String, localName As String, namespaceURI As String) As XmlElement

매개 변수

prefix
String String String String

새 요소의 접두사입니다.The prefix of the new element (if any). String.Empty와 null은 같습니다.String.Empty and null are equivalent.

localName
String String String String

새 요소의 로컬 이름입니다.The local name of the new element.

namespaceURI
String String String String

새 요소의 네임스페이스 URI입니다.The namespace URI of the new element (if any). String.Empty와 null은 같습니다.String.Empty and null are equivalent.

반환

예제

다음 예제에서는 기존 XML 문서에 새 요소를 추가합니다.The following example adds a new element to the existing 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;
   String^ xmlData = "<book xmlns:bk='urn:samples'></book>";
   doc->Load( gcnew StringReader( xmlData ) );
   
   // Create a new element and add it to the document.
   XmlElement^ elem = doc->CreateElement( "bk", "genre", "urn:samples" );
   elem->InnerText = "fantasy";
   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();
    string xmlData = "<book xmlns:bk='urn:samples'></book>";

    doc.Load(new StringReader(xmlData));

    // Create a new element and add it to the document.
    XmlElement elem = doc.CreateElement("bk", "genre", "urn:samples");
    elem.InnerText = "fantasy";
    doc.DocumentElement.AppendChild(elem);

    Console.WriteLine("Display the modified XML...");
    doc.Save(Console.Out);

  }
}
Imports System
Imports System.IO
Imports System.Xml

public class Sample 

  public shared sub Main() 

    ' Create the XmlDocument.
    Dim doc as XmlDocument = new XmlDocument()
    Dim xmlData as string = "<book xmlns:bk='urn:samples'></book>"

    doc.Load(new StringReader(xmlData))

    ' Create a new element and add it to the document.
    Dim elem as XmlElement = doc.CreateElement("bk", "genre", "urn:samples")
    elem.InnerText = "fantasy"
    doc.DocumentElement.AppendChild(elem)

    Console.WriteLine("Display the modified XML...")
    doc.Save(Console.Out)

  end sub
end class

설명

다음 C# 코드The following C# code

XmlElement elem;  
elem=doc.CreateElement("xy", "item", "urn:abc");  

다음 XML 텍스트와 같은 요소를 만듭니다.creates an element equivalent to the following XML text:

<xy:item xmlns:xy="urn:abc"/>  

이 메서드가 문서의 컨텍스트에서 새 개체를 만들고, 있지만 추가 되지 않습니다 자동으로 새 개체를 문서 트리에입니다.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에 따라 Extensible Markup Language (XML) 1.0 권장 사항, EntityReference 특성 노드를 벗어날 때 요소 노드는 EntityReference 노드 및 문서 및 요소의 노드 내에 허용 됩니다.According to the W3C Extensible Markup Language (XML) 1.0 recommendation, Element nodes are allowed within Document and Element nodes, and in EntityReference nodes when the EntityReference is outside an Attribute node.

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

적용 대상