XmlDocument.CreateElement Méthode

Définition

Espace de noms:

System.Xml

Assemblys:

netstandard.dll, System.Xml.ReaderWriter.dll

Crée un XmlElement.

Surcharges

Nom	Description
CreateElement(String)	Crée un élément portant le nom spécifié.
CreateElement(String, String)	Crée un XmlElement avec le nom qualifié et NamespaceURI.
CreateElement(String, String, String)	Crée un élément avec les éléments spécifiés Prefix, LocalNameet NamespaceURI.

CreateElement(String)

Source:

XmlDocument.cs

Crée un élément portant 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 Prefix propriété reflète la partie du nom précédant le signe deux-points et la LocalName propriété reflète la partie du nom après le signe deux-points. Le nom qualifié ne peut pas inclure un préfixe « xmlns ».

Retours

XmlElement

XmlElementNouveau .

Exemples

L’exemple suivant crée un élément et l’ajoute au document.

using System;
using System.Xml;

public class Sample
{
  public static void CreateTextNodeExample()
  {
    // Create the XmlDocument.
    XmlDocument doc = new();
    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);
  }
}

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

L’exemple produit la sortie suivante :

Display the modified XML...
<?xml version="1.0" encoding="utf-8"?>
<book genre="novel" ISBN="1-861001-57-5">
  <title>Pride And Prejudice</title>
  <price>19.95</price>
</book>

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 Element, et dans les nœuds EntityReference lorsque le nœud EntityReference n’est pas un enfant d’un nœud Attribut.

CreateElement(String, String)

Source:

XmlDocument.cs

Crée un XmlElement avec le nom qualifié et 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

Paramètres

qualifiedName

String

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

namespaceURI

String

URI d’espace de noms de l’élément.

Retours

XmlElement

XmlElementNouveau .

Remarques

Code C# suivant :

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

... génère un élément équivalent au code 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.

CreateElement(String, String, String)

Source:

XmlDocument.cs

Crée un élément avec les éléments spécifiés Prefix, LocalNameet 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

Paramètres

prefix

String

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

localName

String

Nom local du nouvel élément.

namespaceURI

String

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

Retours

XmlElement

XmlElementNouveau .

Exemples

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

using System;
using System.IO;
using System.Xml;

public class Sample1
{
  public static void CreateElementExample()
  {
    // Create the XmlDocument.
    XmlDocument doc = new();
    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

Code C# suivant :

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

... crée un élément équivalent au code 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 Élément, 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).