XmlDocument.CreateElement Metodo

Definizione

Crea un XmlElement.Creates an XmlElement.

Overload

CreateElement(String)

Crea un elemento con il nome specificato.Creates an element with the specified name.

CreateElement(String, String)

Crea un oggetto XmlElement con il nome completo e una proprietà NamespaceURI.Creates an XmlElement with the qualified name and NamespaceURI.

CreateElement(String, String, String)

Crea un elemento con le proprietà Prefix, LocalName e NamespaceURI specificate.Creates an element with the specified Prefix, LocalName, and NamespaceURI.

CreateElement(String)

Crea un elemento con il nome specificato.Creates an element with the specified name.

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

Parametri

name
String

Nome completo dell'elemento.The qualified name of the element. Se il nome contiene i due punti, la proprietà Prefix riflette la parte del nome che precede i due punti e la proprietà LocalName la parte che li segue.If the name contains a colon then the Prefix property reflects the part of the name preceding the colon and the LocalName property reflects the part of the name after the colon. Il nome completo non può includere un prefisso"xmlns".The qualified name cannot include a prefix of 'xmlns'.

Restituisce

Nuovo oggetto XmlElement.The new XmlElement.

Esempi

Nell'esempio seguente viene creato un nuovo elemento che viene aggiunto al documento.The following example creates a new element and adds it to the 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

Commenti

Si noti che l'istanza restituita implementa l'interfaccia XmlElement, quindi gli attributi predefiniti verranno creati direttamente nell'oggetto restituito.Note that the instance returned implements the XmlElement interface, so default attributes would be created directly on the returned object.

Sebbene questo metodo crei il nuovo oggetto nel contesto del documento, non aggiunge automaticamente il nuovo oggetto all'albero del documento.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. Per aggiungere il nuovo oggetto, è necessario chiamare in modo esplicito uno dei metodi di inserimento del nodo.To add the new object, you must explicitly call one of the node insert methods.

Secondo la raccomandazione W3C Extensible Markup Language (XML) 1,0, i nodi elemento sono consentiti all'interno di nodi documento ed elemento e nei nodi EntityReference quando il nodo EntityReference non è figlio di un nodo attributo.According to the W3C Extensible Markup Language (XML) 1.0 recommendation, Element nodes are allowed within Document and Element nodes, and in EntityReference nodes when the EntityReference node is not a child of an Attribute node.

CreateElement(String, String)

Crea un oggetto XmlElement con il nome completo e una proprietà NamespaceURI.Creates an XmlElement with the qualified name and 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

Parametri

qualifiedName
String

Nome completo dell'elemento.The qualified name of the element. Se il nome contiene i due punti, la proprietà Prefix rifletterà la parte del nome che precede i due punti e la proprietà LocalName la parte che li segue.If the name contains a colon then the Prefix property will reflect the part of the name preceding the colon and the LocalName property will reflect the part of the name after the colon. Il nome completo non può includere un prefisso"xmlns".The qualified name cannot include a prefix of 'xmlns'.

namespaceURI
String

URI dello spazio dei nomi dell'elemento.The namespace URI of the element.

Restituisce

Nuovo oggetto XmlElement.The new XmlElement.

Commenti

Il codice C# seguenteThe following C# code

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

Restituisce un elemento equivalente al testo XML seguente.results in an element that is equivalent to the following XML text.

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

Sebbene questo metodo crei il nuovo oggetto nel contesto del documento, non aggiunge automaticamente il nuovo oggetto all'albero del documento.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. Per aggiungere il nuovo oggetto, è necessario chiamare in modo esplicito uno dei metodi di inserimento del nodo.To add the new object, you must explicitly call one of the node insert methods.

Secondo la raccomandazione W3C Extensible Markup Language (XML) 1,0, i nodi elemento sono consentiti all'interno di nodi documento ed elemento e nei nodi EntityReference quando il nodo EntityReference non è figlio di un nodo attributo.According to the W3C Extensible Markup Language (XML) 1.0 recommendation, Element nodes are allowed within Document and Element nodes, and in EntityReference nodes when the EntityReference node is not a child of an Attribute node.

CreateElement(String, String, String)

Crea un elemento con le proprietà Prefix, LocalName e NamespaceURI specificate.Creates an element with the specified Prefix, LocalName, and 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

Parametri

prefix
String

Prefisso del nuovo elemento, se presente.The prefix of the new element (if any). String.Empty e null sono equivalenti.String.Empty and null are equivalent.

localName
String

Nome locale del nuovo elemento.The local name of the new element.

namespaceURI
String

URI dello spazio dei nomi del nuovo elemento, se presente.The namespace URI of the new element (if any). String.Empty e null sono equivalenti.String.Empty and null are equivalent.

Restituisce

Nuovo oggetto XmlElement.The new XmlElement.

Esempi

Nell'esempio seguente viene aggiunto un nuovo elemento al documento XML esistente.The following example adds a new element to the existing 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;
   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

Commenti

Il codice C# seguenteThe following C# code

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

Crea un elemento equivalente al testo XML seguente:creates an element equivalent to the following XML text:

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

Sebbene questo metodo crei il nuovo oggetto nel contesto del documento, non aggiunge automaticamente il nuovo oggetto all'albero del documento.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. Per aggiungere il nuovo oggetto, è necessario chiamare in modo esplicito uno dei metodi di inserimento del nodo.To add the new object, you must explicitly call one of the node insert methods.

Secondo la raccomandazione W3C Extensible Markup Language (XML) 1,0, i nodi elemento sono consentiti all'interno di nodi documento ed elemento e nei nodi EntityReference quando EntityReference si trova all'esterno di un nodo attributo.According to the W3C Extensible Markup Language (XML) 1.0 recommendation, Element nodes are allowed within Document and Element nodes, and in EntityReference nodes when the EntityReference is outside an Attribute node.

Questo metodo è un'estensione Microsoft per il Document Object Model (DOM).This method is a Microsoft extension to the Document Object Model (DOM).

Si applica a