XmlTextWriter.WriteStartDocument Metod

Definition

Namnområde:
System.Xml
Sammansättningar:
netstandard.dll, System.Xml.ReaderWriter.dll
Sammansättning:
System.Xml.ReaderWriter.dll
Sammansättning:
System.Xml.dll
Sammansättning:
netstandard.dll

Skriver XML-deklarationen med versionen "1.0".

Överlagringar

Name Description
WriteStartDocument()

Skriver XML-deklarationen med versionen "1.0".
WriteStartDocument(Boolean)

Skriver XML-deklarationen med versionen "1.0" och det fristående attributet.

Kommentarer

Note

Vi rekommenderar att du skapar XmlWriter instanser med hjälp av XmlWriter.Create metoden och XmlWriterSettings klassen för att dra nytta av den nya funktionaliteten.

WriteStartDocument()

Källa:
XmlTextWriter.cs
Källa:
XmlTextWriter.cs
Källa:
XmlTextWriter.cs
Källa:
XmlTextWriter.cs
Källa:
XmlTextWriter.cs

Skriver XML-deklarationen med versionen "1.0".

public:
 override void WriteStartDocument();
public override void WriteStartDocument();
override this.WriteStartDocument : unit -> unit
Public Overrides Sub WriteStartDocument ()

Undantag

InvalidOperationException

Det här är inte den första skrivmetoden som anropas efter konstruktorn.

Exempel

I följande exempel skrivs en XML-fil som representerar en bok.

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

Kommentarer

Note

Vi rekommenderar att du skapar XmlWriter instanser med hjälp av XmlWriter.Create metoden och XmlWriterSettings klassen för att dra nytta av den nya funktionaliteten.

Kodningsnivån för dokumentet bestäms av hur skrivaren implementeras. Om ett Encoding objekt till exempel anges i XmlTextWriter konstruktorn avgör detta värdet för kodningsattributet. Den här metoden skapar inte ett fristående attribut.

När WriteStartDocument kallas skrivaren verifierar att det du skriver är ett välformat XML-dokument. Den kontrollerar till exempel att XML-deklarationen är den första noden, att ett och endast ett element på rotnivå finns och så vidare. Om den här metoden inte anropas förutsätter skrivaren att ett XML-fragment skrivs och inte tillämpar några regler på rotnivå.

Om WriteStartDocument har anropats och sedan WriteProcessingInstruction metoden används för att skapa en annan XML-deklaration genereras ett undantag.

Gäller för

WriteStartDocument(Boolean)

Källa:
XmlTextWriter.cs
Källa:
XmlTextWriter.cs
Källa:
XmlTextWriter.cs
Källa:
XmlTextWriter.cs
Källa:
XmlTextWriter.cs

Skriver XML-deklarationen med versionen "1.0" och det fristående attributet.

public:
 override void WriteStartDocument(bool standalone);
public override void WriteStartDocument(bool standalone);
override this.WriteStartDocument : bool -> unit
Public Overrides Sub WriteStartDocument (standalone As Boolean)

Parametrar

standalone
Boolean

Om trueskriver den "standalone=yes"; om false, skriver den "standalone=no".

Undantag

InvalidOperationException

Det här är inte den första skrivmetoden som anropas efter konstruktorn.

Kommentarer

Note

Vi rekommenderar att du skapar XmlWriter instanser med hjälp av XmlWriter.Create metoden och XmlWriterSettings klassen för att dra nytta av den nya funktionaliteten.

Kodningsnivån för dokumentet bestäms av hur skrivaren implementeras. Om ett Encoding objekt till exempel anges i XmlTextWriter konstruktorn avgör detta värdet för kodningsattributet.

När WriteStartDocument kallas skrivaren verifierar att det du skriver är ett välformat XML-dokument. Den kontrollerar till exempel att XML-deklarationen är den första noden, att ett och endast ett element på rotnivå finns och så vidare. Om den här metoden inte anropas förutsätter skrivaren att ett XML-fragment skrivs och inte tillämpar några regler på rotnivå.

Om WriteStartDocument har anropats och sedan WriteProcessingInstruction metoden används för att skapa en annan XML-deklaration genereras ett undantag.

Gäller för