XmlDocument.CreateXmlDeclaration(String, String, String) Méthode

Définition

Espace de noms:

System.Xml

Assemblys:

System.Xml.dll, System.Xml.XmlDocument.dll

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.XmlDocument.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Crée un nœud XmlDeclaration avec les valeurs spécifiées.

public:
 virtual System::Xml::XmlDeclaration ^ CreateXmlDeclaration(System::String ^ version, System::String ^ encoding, System::String ^ standalone);

public virtual System.Xml.XmlDeclaration CreateXmlDeclaration (string version, string encoding, string standalone);

public virtual System.Xml.XmlDeclaration CreateXmlDeclaration (string version, string? encoding, string? standalone);

abstract member CreateXmlDeclaration : string * string * string -> System.Xml.XmlDeclaration
override this.CreateXmlDeclaration : string * string * string -> System.Xml.XmlDeclaration

Public Overridable Function CreateXmlDeclaration (version As String, encoding As String, standalone As String) As XmlDeclaration

Paramètres

version

String

La version doit être "1.0".

encoding

String

Valeur de l'attribut d'encodage. Il s'agit de l'encodage utilisé quand vous enregistrez un élément XmlDocument dans un fichier ou un flux ; il doit donc être défini avec une chaîne prise en charge par la classe Encoding, sinon Save(String) échoue. Si cette valeur est null ou String.Empty, la méthode Save n'écrit pas d'attribut d'encodage sur la déclaration XML ; le codage par défaut UTF-8 est donc utilisé.

Remarque : si l'élément XmlDocument est enregistré dans un TextWriter ou un XmlTextWriter, cette valeur d'encodage est ignorée. L'encodage du TextWriter ou du XmlTextWriter est utilisé à la place. Cela garantit que le code XML écrit peut être lu en utilisant l'encodage correct.

standalone

String

La valeur doit être "yes" ou "no". Si cette valeur est null ou String.Empty, la méthode Save n'écrit pas d'attribut autonome sur la déclaration XML.

Retours

XmlDeclaration

Nouveau nœud XmlDeclaration.

Exceptions

ArgumentException

Les valeurs de version ou standalone sont différentes de celles spécifiées ci-dessus.

Exemples

L’exemple suivant crée une déclaration XML et l’ajoute au document.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   XmlDocument^ doc = gcnew XmlDocument;
   doc->LoadXml( "<book genre='novel' ISBN='1-861001-57-5'><title>Pride And Prejudice</title></book>" );
   
   //Create an XML declaration. 
   XmlDeclaration^ xmldecl;
   xmldecl = doc->CreateXmlDeclaration( "1.0", nullptr, nullptr );
   
   //Add the new node to the document.
   XmlElement^ root = doc->DocumentElement;
   doc->InsertBefore( xmldecl, root );
   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()
  {
    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "</book>");

    //Create an XML declaration.
    XmlDeclaration xmldecl;
    xmldecl = doc.CreateXmlDeclaration("1.0",null,null);

    //Add the new node to the document.
    XmlElement root = doc.DocumentElement;
    doc.InsertBefore(xmldecl, root);

    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()
        Dim doc As New XmlDocument()
        doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5'>" & _
                    "<title>Pride And Prejudice</title>" & _
                    "</book>")
        
        'Create an XML declaration. 
        Dim xmldecl As XmlDeclaration
        xmldecl = doc.CreateXmlDeclaration("1.0", Nothing, Nothing)
        
        'Add the new node to the document.
        Dim root As XmlElement = doc.DocumentElement
        doc.InsertBefore(xmldecl, root)
        
        Console.WriteLine("Display the modified XML...")
        doc.Save(Console.Out)
    End Sub
End Class

Remarques

Les attributs sont exposés en tant que propriétés spéciales sur le XmlDeclaration nœud, et non en tant que XmlAttribute nœuds.

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, le XmlDeclaration nœud doit être le premier nœud du document.

Cette méthode est une extension Microsoft au modèle objet document (DOM).

Voir aussi

• XmlDeclaration