XmlDocument.CreateXmlDeclaration(String, String, String) Metodo

Definizione

Spazio dei nomi:

System.Xml

Assembly:

netstandard.dll, System.Xml.ReaderWriter.dll

Origine:

XmlDocument.cs

Crea un XmlDeclaration nodo con i valori specificati.

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

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

Parametri

version

String

La versione deve essere "1.0".

encoding

String

Valore dell'attributo di codifica. Si tratta della codifica utilizzata quando si salva l'oggetto XmlDocument in un file o in un flusso, pertanto deve essere impostato su una stringa supportata dalla Encoding classe; in caso contrario Save(String) , non riesce. Se è null o String.Empty, il Save metodo non scrive un attributo di codifica nella dichiarazione XML e pertanto viene utilizzata la codifica predefinita UTF-8.

Nota: se XmlDocument viene salvato in o TextWriter in XmlTextWriter, questo valore di codifica viene rimosso. Viene invece utilizzata la codifica di TextWriter o .XmlTextWriter In questo modo si garantisce che il codice XML scritto possa essere letto nuovamente usando la codifica corretta.

standalone

String

Il valore deve essere "sì" o "no". Se è null o String.Empty, il Save metodo non scrive un attributo autonomo nella dichiarazione XML.

Valori restituiti

XmlDeclaration

XmlDeclaration Nuovo nodo.

Eccezioni

ArgumentException

I valori di version o standalone sono diversi da quelli specificati in precedenza.

Esempio

Nell'esempio seguente viene creata una dichiarazione XML che viene aggiunta al documento.

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

Commenti

Gli attributi vengono esposti come proprietà speciali nel XmlDeclaration nodo e non come XmlAttribute nodi.

Anche se questo metodo crea il nuovo oggetto nel contesto del documento, non aggiunge automaticamente il nuovo oggetto all'albero del documento. Per aggiungere il nuovo oggetto, è necessario chiamare in modo esplicito uno dei metodi di inserimento del nodo.

In base alla raccomandazione W3C Extensible Markup Language (XML) 1.0, il XmlDeclaration nodo deve essere il primo nodo del documento.

Questo metodo è un'estensione Microsoft al dom (Document Object Model).

Vedi anche

• XmlDeclaration