XmlTextWriter.WriteStartDocument Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

Zapíše deklaraci XML s verzí 1.0.

Přetížení

Name	Description
WriteStartDocument()	Zapíše deklaraci XML s verzí 1.0.
WriteStartDocument(Boolean)	Zapíše deklaraci XML s verzí 1.0 a samostatným atributem.

Poznámky

Note

Doporučujeme vytvářet XmlWriter instance pomocí XmlWriter.Create metody a XmlWriterSettings třídy, abyste mohli využívat nové funkce.

WriteStartDocument()

Zdroj:

XmlTextWriter.cs

Zapíše deklaraci XML s verzí 1.0.

public:
 override void WriteStartDocument();

public override void WriteStartDocument();

override this.WriteStartDocument : unit -> unit

Public Overrides Sub WriteStartDocument ()

Výjimky

InvalidOperationException

Nejedná se o první metodu zápisu volanou po konstruktoru.

Příklady

Následující příklad zapíše soubor XML představující knihu.

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

public class Sample
{
  private const string filename = "sampledata.xml";

  public static void Main()
  {
     XmlTextWriter writer = null;

     writer = new XmlTextWriter (filename, null);
     //Use indenting for readability.
     writer.Formatting = Formatting.Indented;

     //Write the XML delcaration.
     writer.WriteStartDocument();

     //Write the ProcessingInstruction node.
     String PItext="type='text/xsl' href='book.xsl'";
     writer.WriteProcessingInstruction("xml-stylesheet", PItext);

     //Write the DocumentType node.
     writer.WriteDocType("book", null , null, "<!ENTITY h 'hardcover'>");

     //Write a Comment node.
     writer.WriteComment("sample XML");

     //Write a root element.
     writer.WriteStartElement("book");

     //Write the genre attribute.
     writer.WriteAttributeString("genre", "novel");

     //Write the ISBN attribute.
     writer.WriteAttributeString("ISBN", "1-8630-014");

     //Write the title.
     writer.WriteElementString("title", "The Handmaid's Tale");

     //Write the style element.
     writer.WriteStartElement("style");
     writer.WriteEntityRef("h");
     writer.WriteEndElement();

     //Write the price.
     writer.WriteElementString("price", "19.95");

     //Write CDATA.
     writer.WriteCData("Prices 15% off!!");

     //Write the close tag for the root element.
     writer.WriteEndElement();

     writer.WriteEndDocument();

     //Write the XML to file and close the writer.
     writer.Flush();
     writer.Close();

     //Load the file into an XmlDocument to ensure well formed XML.
     XmlDocument doc = new XmlDocument();
     //Preserve white space for readability.
     doc.PreserveWhitespace = true;
     //Load the file.
     doc.Load(filename);

     //Display the XML content to the console.
     Console.Write(doc.InnerXml);
  }
}

Option Explicit
Option Strict

Imports System.IO
Imports System.Xml

Public Class Sample
    Private Shared filename As String = "sampledata.xml"
    Public Shared Sub Main()
        Dim writer As XmlTextWriter = Nothing
        
        writer = New XmlTextWriter(filename, Nothing)
        'Use indenting for readability.
        writer.Formatting = Formatting.Indented
        
        'Write the XML delcaration. 
        writer.WriteStartDocument()
        
        'Write the ProcessingInstruction node.
        Dim PItext As String = "type='text/xsl' href='book.xsl'"
        writer.WriteProcessingInstruction("xml-stylesheet", PItext)
        
        'Write the DocumentType node.
        writer.WriteDocType("book", Nothing, Nothing, "<!ENTITY h 'hardcover'>")
        
        'Write a Comment node.
        writer.WriteComment("sample XML")
        
        'Write a root element.
        writer.WriteStartElement("book")
        
        'Write the genre attribute.
        writer.WriteAttributeString("genre", "novel")
        
        'Write the ISBN attribute.
        writer.WriteAttributeString("ISBN", "1-8630-014")
        
        'Write the title.
        writer.WriteElementString("title", "The Handmaid's Tale")
        
        'Write the style element.
        writer.WriteStartElement("style")
        writer.WriteEntityRef("h")
        writer.WriteEndElement()
        
        'Write the price.
        writer.WriteElementString("price", "19.95")
        
        'Write CDATA.
        writer.WriteCData("Prices 15% off!!")
        
        'Write the close tag for the root element.
        writer.WriteEndElement()
        
        writer.WriteEndDocument()
        
        'Write the XML to file and close the writer.
        writer.Flush()
        writer.Close()
        
        'Load the file into an XmlDocument to ensure well formed XML.
        Dim doc As New XmlDocument()
        'Preserve white space for readability.
        doc.PreserveWhitespace = True
        'Load the file.
        doc.Load(filename)
        
        'Display the XML content to the console.
        Console.Write(doc.InnerXml)
    End Sub
End Class

Poznámky

Note

Doporučujeme vytvářet XmlWriter instance pomocí XmlWriter.Create metody a XmlWriterSettings třídy, abyste mohli využívat nové funkce.

Úroveň kódování dokumentu určuje způsob implementace zapisovače. Pokud je například Encoding objekt zadán v konstruktoru XmlTextWriter , určuje hodnotu atributu kódování. Tato metoda nevytvoří samostatný atribut.

Když WriteStartDocument se zapisovač nazývá, ověří, že to, co píšete, je dobře formátovaný dokument XML. Například zkontroluje, že deklarace XML je první uzel, že jeden a pouze jeden prvek kořenové úrovně existuje atd. Pokud tato metoda není volána, zapisovač předpokládá, že se zapisuje fragment XML a nepoužívá žádná pravidla kořenové úrovně.

Pokud WriteStartDocument byl volán a pak WriteProcessingInstruction se metoda používá k vytvoření další deklarace XML, je vyvolána výjimka.

WriteStartDocument(Boolean)

Zdroj:

XmlTextWriter.cs

Zapíše deklaraci XML s verzí 1.0 a samostatným atributem.

public:
 override void WriteStartDocument(bool standalone);

public override void WriteStartDocument(bool standalone);

override this.WriteStartDocument : bool -> unit

Public Overrides Sub WriteStartDocument (standalone As Boolean)

Parametry

standalone

Boolean

Pokud true, zapíše "standalone=yes"; pokud false, zapíše "standalone=no".

Výjimky

InvalidOperationException

Nejedná se o první metodu zápisu volanou po konstruktoru.

Poznámky

Note

Doporučujeme vytvářet XmlWriter instance pomocí XmlWriter.Create metody a XmlWriterSettings třídy, abyste mohli využívat nové funkce.

Úroveň kódování dokumentu určuje způsob implementace zapisovače. Pokud je například Encoding objekt zadán v konstruktoru XmlTextWriter , určuje hodnotu atributu kódování.

Když WriteStartDocument se zapisovač nazývá, ověří, že to, co píšete, je dobře formátovaný dokument XML. Například zkontroluje, že deklarace XML je první uzel, že jeden a pouze jeden prvek kořenové úrovně existuje atd. Pokud tato metoda není volána, zapisovač předpokládá, že se zapisuje fragment XML a nepoužívá žádná pravidla kořenové úrovně.

Pokud WriteStartDocument byl volán a pak WriteProcessingInstruction se metoda používá k vytvoření další deklarace XML, je vyvolána výjimka.