XmlTextWriter.WriteStartDocument 메서드

  • 참조

정의

네임스페이스:
System.Xml
어셈블리:
System.Xml.ReaderWriter.dll
어셈블리:
System.Xml.dll
어셈블리:
netstandard.dll

버전 "1.0"을 사용하여 XML 선언을 작성합니다.

오버로드

WriteStartDocument()

버전 "1.0"을 사용하여 XML 선언을 작성합니다.
WriteStartDocument(Boolean)

버전 "1.0"과 독립형 특성을 사용하여 XML 선언을 작성합니다.

설명

참고

.NET Framework 2.0부터 메서드와 XmlWriterSettings 클래스를 사용하여 XmlWriter.Create 인스턴스를 만들어 XmlWriter 새 기능을 활용하는 것이 좋습니다.

WriteStartDocument()

버전 "1.0"을 사용하여 XML 선언을 작성합니다.

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

예외

InvalidOperationException

생성자 다음에 호출된 첫 번째 쓰기 메서드가 아닌 경우

예제

다음 예제에서는 책을 나타내는 XML 파일을 씁니다.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   XmlTextWriter^ writer = nullptr;
   String^ filename = "sampledata.xml";
   writer = gcnew XmlTextWriter( filename, nullptr );
   
   //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", nullptr, nullptr, "<!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 = gcnew 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 );
}

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

설명

참고

.NET Framework 2.0부터 메서드와 XmlWriterSettings 클래스를 사용하여 XmlWriter.Create 인스턴스를 만들어 XmlWriter 새 기능을 활용하는 것이 좋습니다.

문서의 인코딩 수준은 작성기가 구현되는 방식에 따라 결정됩니다. 예를 들어 개체가 Encoding 생성자에 지정된 XmlTextWriter 경우 인코딩 특성의 값이 결정됩니다. 이 메서드는 독립 실행형 특성을 만들지 않습니다.

WriteStartDocument 작성기가 호출되면 작성자가 작성하는 내용이 올바른 형식의 XML 문서인지 확인합니다. 예를 들어 XML 선언이 첫 번째 노드이고 루트 수준 요소 하나만 존재하는지 확인합니다. 이 메서드가 호출되지 않으면 작성기는 XML 조각이 작성되고 있다고 가정하고 루트 수준 규칙을 적용하지 않습니다.

호출된 다음 메서드를 WriteProcessingInstruction 사용하여 다른 XML 선언을 만들면 WriteStartDocument 예외가 throw됩니다.

적용 대상

WriteStartDocument(Boolean)

버전 "1.0"과 독립형 특성을 사용하여 XML 선언을 작성합니다.

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

매개 변수

standalone
Boolean

true이면 "standalone=yes"로 작성하고, false이면 "standalone=no"로 작성합니다.

예외

InvalidOperationException

생성자 다음에 호출된 첫 번째 쓰기 메서드가 아닌 경우

설명

참고

.NET Framework 2.0부터 메서드와 XmlWriterSettings 클래스를 사용하여 XmlWriter.Create 새 기능을 활용하여 인스턴스를 만드는 XmlWriter 것이 좋습니다.

문서의 인코딩 수준은 작성기 구현 방법에 따라 결정됩니다. 예를 들어 생성자에 개체를 XmlTextWriter 지정하면 Encoding 인코딩 특성의 값이 결정됩니다.

WriteStartDocument 기록기라고 하면 작성자가 작성하는 내용이 올바른 형식의 XML 문서인지 확인합니다. 예를 들어 XML 선언이 첫 번째 노드인지, 루트 수준 요소가 하나만 존재하는지 확인합니다. 이 메서드가 호출되지 않으면 작성기는 XML 조각이 작성되고 있다고 가정하고 루트 수준 규칙을 적용하지 않습니다.

호출된 다음 메서드를 WriteProcessingInstruction 사용하여 다른 XML 선언을 만들면 WriteStartDocument 예외가 throw됩니다.

적용 대상