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)

指定したノード型、Name、および NamespaceURI を使用して、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)

指定した XmlNodeTypeName、および NamespaceURI を使用して、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)

指定した XmlNodeTypePrefixName、および NamespaceURI を使用して、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)

指定したノード型、Name、および NamespaceURI を使用して、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. 名前にコロンが含まれている場合は、解析結果は Prefix コンポーネントと LocalName コンポーネントになります。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.

戻り値

新しい XmlNodeThe 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
コメントcomment コメントComment
ドキュメントdocument ドキュメントDocument
documentfragmentdocumentfragment DocumentFragmentDocumentFragment
documenttypedocumenttype DocumentTypeDocumentType
要素element 要素Element
entityreferenceentityreference EntityReferenceEntityReference
processinginstructionprocessinginstruction ProcessingInstructionProcessingInstruction
xmlnodetype.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. 新しいオブジェクトを追加するには、ノードの挿入メソッドの1つを明示的に呼び出す必要があります。To add the new object, you must explicitly call one of the node insert methods.

次の表は、W3C拡張マークアップ言語 (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 no no no no no no no no no
DocumentType yes no no no no no no no no
XmlDeclaration イエスyes* no no no no no no no no
Element yes no no yes no no no no はい * * *yes***
Attribute no no no はい * * * *yes**** no no no no no
Text no no no yes yes no no no yes
CDATA no no no yes no no no no はい * * *yes***
Markup** yes no no yes no no no no no
EntityReference no no no yes yes no no no yes

*XmlDeclaration ノードは、ドキュメントノードの最初の子である必要があります。* The XmlDeclaration node must be the first child of the Document node.

* * マークアップには、ProcessingInstruction ノードと Comment ノードが含まれています。** Markup includes ProcessingInstruction and Comment nodes.

EntityReference ノードが属性ノードの子でない場合、要素ノードと CDATA ノードは 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)

指定した XmlNodeTypeName、および NamespaceURI を使用して、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

新しいノードの XmlNodeTypeThe XmlNodeType of the new node.

name
String String String String

新しいノードの修飾名。The qualified name of the new node. 名前にコロンが含まれている場合は、解析結果は Prefix コンポーネントと LocalName コンポーネントになります。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.

戻り値

新しい XmlNodeThe 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 'Sample

注釈

このメソッドでは、ドキュメントのコンテキストで新しいオブジェクトが作成されますが、新しいオブジェクトがドキュメントツリーに自動的に追加されることはありません。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 の推奨事項に従って、別の 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 no no no no no no no no no
DocumentType yes no no no no no no no no
XmlDeclaration イエスyes* no no no no no no no no
Element yes no no yes no no no no はい * * *yes***
Attribute no no no はい * * * *yes**** no no no no no
Text no no no yes yes no no no yes
CDATA no no no yes no no no no はい * * *yes***
Markup** yes no no yes no no no no no
EntityReference no no no yes yes no no no yes

*XmlDeclaration ノードは、ドキュメントノードの最初の子である必要があります。* The XmlDeclaration node must be the first child of the Document node.

* * マークアップには、ProcessingInstruction ノードと Comment ノードが含まれています。** Markup includes ProcessingInstruction and Comment nodes.

EntityReference ノードが属性ノードの子でない場合、要素ノードと CDATA ノードは 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)

指定した XmlNodeTypePrefixName、および NamespaceURI を使用して、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

新しいノードの XmlNodeTypeThe 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.

戻り値

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

次の表は、W3C拡張マークアップ言語 (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 no no no no no no no no no
DocumentType yes no no no no no no no no
XmlDeclaration イエスyes* no no no no no no no no
Element yes no no yes no no no no はい * * *yes***
Attribute no no no はい * * * *yes**** no no no no no
Text no no no yes yes no no no yes
CDATA no no no yes no no no no はい * * *yes***
Markup** yes no no yes no no no no no
EntityReference no no no yes yes no no no yes

*XmlDeclaration ノードは、ドキュメントノードの最初の子である必要があります。* The XmlDeclaration node must be the first child of the Document node.

* * マークアップには、ProcessingInstruction ノードと Comment ノードが含まれています。** Markup includes ProcessingInstruction and Comment nodes.

EntityReference ノードが属性ノードの子でない場合、要素ノードと CDATA ノードは 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).

適用対象