XmlTextWriter.WriteStartDocument Metódus

Definíció

Névtér:

System.Xml

Szerelvények:

netstandard.dll, System.Xml.ReaderWriter.dll

Az XML-deklarációt az "1.0" verzióval írja.

Túlterhelések

Név	Description
WriteStartDocument()	Az XML-deklarációt az "1.0" verzióval írja.
WriteStartDocument(Boolean)	Az XML-deklarációt az "1.0" verzióval és az önálló attribútummal írja.

Megjegyzések

Note

Javasoljuk, hogy a XmlWriter metódus és a XmlWriter.Create osztály használatával hozzon létre XmlWriterSettings példányokat az új funkciók előnyeinek kihasználásához.

WriteStartDocument()

Forrás:

XmlTextWriter.cs

Az XML-deklarációt az "1.0" verzióval írja.

public:
 override void WriteStartDocument();

public override void WriteStartDocument();

override this.WriteStartDocument : unit -> unit

Public Overrides Sub WriteStartDocument ()

Kivételek

InvalidOperationException

A konstruktor után nem ez az első írási módszer.

Példák

Az alábbi példa egy könyvnek megfelelő XML-fájlt ír.

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

Megjegyzések

Note

Javasoljuk, hogy a XmlWriter metódus és a XmlWriter.Create osztály használatával hozzon létre XmlWriterSettings példányokat az új funkciók előnyeinek kihasználásához.

A dokumentum kódolási szintjét az író implementálása határozza meg. Ha például egy Encoding objektum van megadva a XmlTextWriter konstruktorban, ez határozza meg a kódolási attribútum értékét. Ez a metódus nem hoz létre önálló attribútumot.

Amikor WriteStartDocument az írónak hívják, ellenőrzi, hogy az éppen írt dokumentum egy jól formázott XML-dokumentum-e. Ellenőrzi például, hogy az XML-deklaráció az első csomópont- és egy gyökérszintű elem létezik-e, és így tovább. Ha ezt a metódust nem hívják meg, az író feltételezi, hogy xml-töredék van megírva, és nem alkalmaz gyökérszintű szabályokat.

Ha WriteStartDocument a rendszer meghívta, majd a WriteProcessingInstruction metódust egy másik XML-deklaráció létrehozásához használja, a rendszer kivételt okoz.

WriteStartDocument(Boolean)

Forrás:

XmlTextWriter.cs

Az XML-deklarációt az "1.0" verzióval és az önálló attribútummal írja.

public:
 override void WriteStartDocument(bool standalone);

public override void WriteStartDocument(bool standalone);

override this.WriteStartDocument : bool -> unit

Public Overrides Sub WriteStartDocument (standalone As Boolean)

Paraméterek

standalone

Boolean

Ha truea "standalone=yes" szöveget írja, ha falsea "standalone=nem" szöveget írja.

Kivételek

InvalidOperationException

A konstruktor után nem ez az első írási módszer.

Megjegyzések

Note

Javasoljuk, hogy a XmlWriter metódus és a XmlWriter.Create osztály használatával hozzon létre XmlWriterSettings példányokat az új funkciók előnyeinek kihasználásához.

A dokumentum kódolási szintjét az író implementálása határozza meg. Ha például egy Encoding objektum van megadva a XmlTextWriter konstruktorban, ez határozza meg a kódolási attribútum értékét.

Amikor WriteStartDocument az írónak hívják, ellenőrzi, hogy az éppen írt dokumentum egy jól formázott XML-dokumentum-e. Ellenőrzi például, hogy az XML-deklaráció az első csomópont- és egy gyökérszintű elem létezik-e, és így tovább. Ha ezt a metódust nem hívják meg, az író feltételezi, hogy xml-töredék van megírva, és nem alkalmaz gyökérszintű szabályokat.

Ha WriteStartDocument a rendszer meghívta, majd a WriteProcessingInstruction metódust egy másik XML-deklaráció létrehozásához használja, a rendszer kivételt okoz.