XmlDocument.CreateElement メソッド (String, String, String)

指定した Prefix 、 LocalName 、および NamespaceURI を使用して、要素を作成します。

Overloads Public Overridable Function CreateElement( _
   ByVal prefix As String, _   ByVal localName As String, _   ByVal namespaceURI As String _) As XmlElement
[C#]
public virtual XmlElement CreateElement(stringprefix,stringlocalName,stringnamespaceURI);
[C++]
public: virtual XmlElement* CreateElement(String* prefix,String* localName,String* namespaceURI);
[JScript]
public function CreateElement(
   prefix : String,localName : String,namespaceURI : String) : XmlElement;

パラメータ

• prefix
  新しい要素のプリフィックス (存在する場合)。String.Empty と null 参照 (Visual Basic では Nothing) は等価です。
• localName
  新しい要素のローカル名。
• namespaceURI
  新しい要素の名前空間 URI (存在する場合)。String.Empty と null 参照 (Visual Basic では Nothing) は等価です。

戻り値

新しい XmlElement 。

解説

次の C# コードでは、

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

次の XML テキストと等価の要素が作成されます。

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

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

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

このメソッドは、ドキュメント オブジェクト モデル (DOM: Document Object Model) に対する Microsoft 拡張機能です。

使用例

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

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

  }
}

[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();
    String* xmlData = S"<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(S"bk", S"genre", S"urn:samples");
    elem->InnerText = S"fantasy";
    doc->DocumentElement->AppendChild(elem);

    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 オーバーロードの一覧