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)

指定した PrefixLocalName、および NamespaceURI を使用して、要素を作成します。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'.

戻り値

新しい XmlElementThe 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.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. 新しいオブジェクトを追加するには、ノードの挿入メソッドの1つを明示的に呼び出す必要があります。To add the new object, you must explicitly call one of the node insert methods.

W3C拡張マークアップ言語 (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.

戻り値

新しい XmlElementThe 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. 新しいオブジェクトを追加するには、ノードの挿入メソッドの1つを明示的に呼び出す必要があります。To add the new object, you must explicitly call one of the node insert methods.

W3C拡張マークアップ言語 (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)

指定した PrefixLocalName、および NamespaceURI を使用して、要素を作成します。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.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. 新しいオブジェクトを追加するには、ノードの挿入メソッドの1つを明示的に呼び出す必要があります。To add the new object, you must explicitly call one of the node insert methods.

W3C拡張マークアップ言語 (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).

適用対象