XmlDocument.CreateNode Méthode

Définition

Espace de noms:: System.Xml

Assemblys:: System.Xml.dll, System.Xml.XmlDocument.dll

Assemblys:: netstandard.dll, System.Xml.ReaderWriter.dll

Assembly:: System.Xml.XmlDocument.dll

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Crée un XmlNode.

Surcharges

Nom	Description
CreateNode(String, String, String)	Crée un XmlNode avec le type de nœud spécifié, Nameet NamespaceURI.
CreateNode(XmlNodeType, String, String)	Crée un XmlNode avec les données spécifiées XmlNodeType, Nameet NamespaceURI.
CreateNode(XmlNodeType, String, String, String)	Crée un XmlNode avec les données spécifiées XmlNodeType, Prefix, Nameet NamespaceURI.

CreateNode(String, String, String)

Source:: XmlDocument.cs

Source:: XmlDocument.cs

Source:: XmlDocument.cs

Source:: XmlDocument.cs

Source:: XmlDocument.cs

Crée un XmlNode avec le type de nœud spécifié, Nameet 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);

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

Paramètres

nodeTypeString: String

Version de chaîne XmlNodeType du nouveau nœud. Ce paramètre doit être l’une des valeurs répertoriées dans le tableau ci-dessous.

name: String

Nom qualifié du nouveau nœud. Si le nom contient un signe deux-points, il est analysé dans et dans Prefix les LocalName composants.

namespaceURI: String

URI d’espace de noms du nouveau nœud.

Retours

XmlNode

XmlNodeNouveau .

Exceptions

ArgumentException

Le nom n’a pas été fourni et le XmlNodeType nom nécessite un nom ; ou nodeTypeString n’est pas l’une des chaînes répertoriées ci-dessous.

Exemples

L’exemple suivant crée un élément et l’insère dans le document.

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

Remarques

Le paramètre respecte la nodeTypeString casse et doit être l’une des valeurs du tableau suivant.

nodeTypeString	XmlNodeType
Attribut	Caractéristique
cdatasection	CDATA
comment	Commentaire
document	Document
documentfragment	DocumentFragment
documenttype	Type de document
element	Élément
Entityreference	EntityReference
processinginstruction	Instruction de traitement
significantwhitespace	SignificantWhitespace
text	Texte
whitespace	Espace blanc

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.

Le tableau suivant montre ce que NodeType[row] est autorisé à l’intérieur d’un autre NodeType[colonne] selon la recommandation W3C Extensible Markup Language (XML) 1.0.

Type de nœud	Document	Type de document	Déclaration XML	Élément	Caractéristique	Texte	CDATA	balisage	EntityReference
`Document`	non	non	non	non	non	non	non	non	non
`DocumentType`	oui	non	non	non	non	non	non	non	non
`XmlDeclaration`	Oui*	non	non	non	non	non	non	non	non
`Element`	oui	non	non	oui	non	non	non	non	Oui†
`Attribute`	non	non	non	Oui^>	non	non	non	non	non
`Text`	non	non	non	oui	oui	non	non	non	oui
`CDATA`	non	non	non	oui	non	non	non	non	Oui†
`Markup` ^§	oui	non	non	oui	non	non	non	non	non
`EntityReference`	non	non	non	oui	oui	non	non	non	oui

* Le XmlDeclaration nœud doit être le premier enfant du nœud Document.

§ Markup inclut ProcessingInstruction et Comment nœuds.

Element† et CDATA les nœuds sont autorisés uniquement dans EntityReference les nœuds lorsque le EntityReference nœud n’est pas un enfant d’un Attribute nœud.

• Les attributs ne sont pas des enfants d’un Element nœud. Les attributs sont contenus dans une collection d’attributs qui appartient à un Element nœud.

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

S’applique à

CreateNode(XmlNodeType, String, String)

Source:: XmlDocument.cs

Source:: XmlDocument.cs

Source:: XmlDocument.cs

Source:: XmlDocument.cs

Source:: XmlDocument.cs

Crée un XmlNode avec les données spécifiées XmlNodeType, Nameet 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);

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

Paramètres

type: XmlNodeType

Du XmlNodeType nouveau nœud.

name: String

Nom qualifié du nouveau nœud. Si le nom contient un signe deux-points, il est analysé dans et dans Prefix les LocalName composants.

namespaceURI: String

URI d’espace de noms du nouveau nœud.

Retours

XmlNode

XmlNodeNouveau .

Exceptions

ArgumentException

Le nom n’a pas été fourni et le XmlNodeType nom nécessite un nom.

Exemples

L’exemple suivant crée un élément et l’insère dans un document XML.

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

Remarques

Le tableau suivant montre ce que NodeType[row] est autorisé à l’intérieur d’un autre NodeType[colonne] selon la recommandation W3C Extensible Markup Language (XML) 1.0.

Type de nœud	Document	Type de document	Déclaration XML	Élément	Caractéristique	Texte	CDATA	balisage	EntityReference
`Document`	non	non	non	non	non	non	non	non	non
`DocumentType`	oui	non	non	non	non	non	non	non	non
`XmlDeclaration`	Oui*	non	non	non	non	non	non	non	non
`Element`	oui	non	non	oui	non	non	non	non	Oui†
`Attribute`	non	non	non	Oui>	non	non	non	non	non
`Text`	non	non	non	oui	oui	non	non	non	oui
`CDATA`	non	non	non	oui	non	non	non	non	Oui†
`Markup`§	oui	non	non	oui	non	non	non	non	non
`EntityReference`	non	non	non	oui	oui	non	non	non	oui

* Le XmlDeclaration nœud doit être le premier enfant du nœud Document.

§ Markup inclut ProcessingInstruction et Comment nœuds.

Element† et CDATA les nœuds sont autorisés uniquement dans EntityReference les nœuds lorsque le EntityReference nœud n’est pas un enfant d’un Attribute nœud.

• Les attributs ne sont pas des enfants d’un Element nœud. Les attributs sont contenus dans une collection d’attributs qui appartient à un Element nœud.

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

S’applique à

CreateNode(XmlNodeType, String, String, String)

Source:: XmlDocument.cs

Source:: XmlDocument.cs

Source:: XmlDocument.cs

Source:: XmlDocument.cs

Source:: XmlDocument.cs

Crée un XmlNode avec les données spécifiées XmlNodeType, Prefix, Nameet 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);

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

Paramètres

type: XmlNodeType

Du XmlNodeType nouveau nœud.

prefix: String

Préfixe du nouveau nœud.

name: String

Nom local du nouveau nœud.

namespaceURI: String

URI d’espace de noms du nouveau nœud.

Retours

XmlNode

XmlNodeNouveau .

Exceptions

ArgumentException

Le nom n’a pas été fourni et le XmlNodeType nom nécessite un nom.

Exemples

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

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

Remarques

Le tableau suivant montre ce que NodeType[row] est autorisé à l’intérieur d’un autre NodeType[colonne] selon la recommandation W3C Extensible Markup Language (XML) 1.0.

	Document	Type de document	Déclaration XML	Élément	Caractéristique	Texte	CDATA	balisage	EntityReference
`Document`	non	non	non	non	non	non	non	non	non
`DocumentType`	oui	non	non	non	non	non	non	non	non
`XmlDeclaration`	Oui*	non	non	non	non	non	non	non	non
`Element`	oui	non	non	oui	non	non	non	non	Oui†
`Attribute`	non	non	non	Oui>	non	non	non	non	non
`Text`	non	non	non	oui	oui	non	non	non	oui
`CDATA`	non	non	non	oui	non	non	non	non	Oui†
`Markup`§	oui	non	non	oui	non	non	non	non	non
`EntityReference`	non	non	non	oui	oui	non	non	non	oui

* Le nœud XmlDeclaration doit être le premier enfant du nœud Document.

§ Markup inclut ProcessingInstruction et Comment nœuds.

Element† et CDATA les nœuds sont autorisés uniquement dans EntityReference les nœuds lorsque le EntityReference nœud n’est pas un enfant d’un Attribute nœud.

• Les attributs ne sont pas des enfants d’un Element nœud. Les attributs sont contenus dans une collection d’attributs qui appartient à un Element nœud.

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

S’applique à

Commentaires

Cette page a-t-elle été utile ?