Partager via


XmlDocument.CreateElement Méthode

Définition

Crée un objet XmlElement.

Surcharges

CreateElement(String)

Crée un élément avec le nom spécifié.

CreateElement(String, String)

Crée un élément XmlElement avec le nom qualifié et l'élément NamespaceURI.

CreateElement(String, String, String)

Crée un élément avec les éléments Prefix, LocalName et NamespaceURI spécifiés.

CreateElement(String)

Crée un élément avec le nom spécifié.

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

Paramètres

name
String

Nom qualifié de l'élément. Si le nom contient un signe deux-points, la propriété Prefix reflète la partie du nom qui précède le signe deux-points et la propriété LocalName reflète la partie du nom qui suit le signe deux-points. Le nom qualifié ne peut pas contenir le préfixe « xmlns ».

Retours

XmlElement

Nouvelle XmlElement.

Exemples

L’exemple suivant crée un élément et l’ajoute au 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
End Class

Remarques

Notez que l’instance retournée implémente l’interface XmlElement . Par conséquent, les attributs par défaut sont créés directement sur l’objet retourné.

Bien que cette méthode crée le nouvel objet dans le contexte du document, il n’ajoute pas automatiquement le nouvel objet à l’arborescence de documents. Pour ajouter le nouvel objet, vous devez appeler explicitement l’une des méthodes d’insertion de nœud.

Selon la recommandation W3C Extensible Markup Language (XML) 1.0, les nœuds d’élément sont autorisés dans les nœuds Document et Élément, et dans les nœuds EntityReference lorsque le nœud EntityReference n’est pas un enfant d’un nœud d’attribut.

S’applique à

CreateElement(String, String)

Crée un élément XmlElement avec le nom qualifié et l'élément NamespaceURI.

public:
 System::Xml::XmlElement ^ CreateElement(System::String ^ qualifiedName, System::String ^ namespaceURI);
public System.Xml.XmlElement CreateElement (string qualifiedName, 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

Paramètres

qualifiedName
String

Nom qualifié de l'élément. Si le nom contient un signe deux-points, la propriété Prefix reflète la partie du nom qui précède le signe deux-points et la propriété LocalName reflète la partie du nom qui suit le signe deux-points. Le nom qualifié ne peut pas contenir le préfixe « xmlns ».

namespaceURI
String

L'URI de l'espace de noms de l'élément.

Retours

XmlElement

Nouvelle XmlElement.

Remarques

Le code C# suivant

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

génère un élément équivalent au texte XML suivant.

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

Bien que cette méthode crée le nouvel objet dans le contexte du document, il n’ajoute pas automatiquement le nouvel objet à l’arborescence de documents. Pour ajouter le nouvel objet, vous devez appeler explicitement l’une des méthodes d’insertion de nœud.

Selon la recommandation W3C Extensible Markup Language (XML) 1.0, les nœuds d’élément sont autorisés dans les nœuds Document et Element, et dans les nœuds EntityReference lorsque le nœud EntityReference n’est pas un enfant d’un nœud Attribut.

S’applique à

CreateElement(String, String, String)

Crée un élément avec les éléments Prefix, LocalName et NamespaceURI spécifiés.

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

Paramètres

prefix
String

Préfixe du nouvel élément (le cas échéant). String.Empty et null sont équivalents.

localName
String

Le nom local du nouvel élément.

namespaceURI
String

URI de l'espace de noms du nouvel élément (le cas échéant). String.Empty et null sont équivalents.

Retours

XmlElement

Nouvelle XmlElement.

Exemples

L’exemple suivant ajoute un nouvel élément au document XML existant.

#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

Remarques

Le code C# suivant

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

crée un élément équivalent au texte XML suivant :

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

Bien que cette méthode crée le nouvel objet dans le contexte du document, il n’ajoute pas automatiquement le nouvel objet à l’arborescence de documents. Pour ajouter le nouvel objet, vous devez appeler explicitement l’une des méthodes d’insertion de nœud.

Selon la recommandation W3C Extensible Markup Language (XML) 1.0, les nœuds d’élément sont autorisés dans les nœuds Document et Element, et dans les nœuds EntityReference lorsque EntityReference se trouve en dehors d’un nœud d’attribut.

Cette méthode est une extension Microsoft au dom (Document Object Model).

S’applique à