次の方法で共有

XmlDocument.CreateElement メソッド (String)

  • [アーティクル]

指定した名前を使用して要素を作成します。

Overloads Public Function CreateElement( _
   ByVal name As String _) As XmlElement
[C#]
public XmlElement CreateElement(stringname);
[C++]
public: XmlElement* CreateElement(String* name);
[JScript]
public function CreateElement(
   name : String) : XmlElement;

パラメータ

  • name
    要素の限定名。名前にコロンが含まれている場合は、名前のうちコロンの前にある部分が Prefix プロパティに反映され、コロンの後ろの部分が LocalName プロパティに反映されます。限定名に 'xmlns' というプリフィックスを含めることはできません。

戻り値

新しい XmlElement 。

解説

返されたインスタンスは XmlElement インターフェイスを実装するため、既定の属性が返されたオブジェクト上に直接作成されます。

このメソッドは、ドキュメントのコンテキスト内で新しいオブジェクトを作成しますが、自動的には新しいオブジェクトをドキュメント ツリーに追加しません。新しいオブジェクトを追加するには、ノード挿入メソッドのいずれか 1 つを明示的に呼び出す必要があります。

W3C 勧告『Extensible Markup Language (XML) 1.0』(www.w3.org/TR/1998/REC-xml-19980210) に従って、Element ノードは、Document ノードおよび Element ノード内で使用でき、EntityReference ノードが Attribute ノードの子でない場合は EntityReference ノードでも使用できます。

使用例

[Visual Basic, C#, C++] 新しい要素を作成し、ドキュメントに追加する例を次に示します。

 
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

[C#] 
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);

  }
}

[C++] 
#using <mscorlib.dll>
#using <System.Xml.dll>
using namespace System;
using namespace System::IO;
using namespace System::Xml;

int main()
{
    //Create the XmlDocument.
    XmlDocument* doc = new XmlDocument();
    doc->LoadXml(S"<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(S"price");
    XmlText* text = doc->CreateTextNode(S"19.95");
    doc->DocumentElement->AppendChild(elem);
    doc->DocumentElement->LastChild->AppendChild(text);

    Console::WriteLine(S"Display the modified XML...");
    doc->Save(Console::Out);
}

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン 言語のフィルタ をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

XmlDocument クラス | XmlDocument メンバ | System.Xml 名前空間 | XmlDocument.CreateElement オーバーロードの一覧