Aracılığıyla paylaş

XmlTextWriter.WriteStartDocument Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Xml
Bütünleştirilmiş Kod:
System.Xml.ReaderWriter.dll
Bütünleştirilmiş Kod:
System.Xml.dll
Bütünleştirilmiş Kod:
netstandard.dll

XML bildirimini "1.0" sürümüyle yazar.

Aşırı Yüklemeler

WriteStartDocument()

XML bildirimini "1.0" sürümüyle yazar.
WriteStartDocument(Boolean)

XML bildirimini "1.0" sürümü ve tek başına özniteliğiyle yazar.

Açıklamalar

Not

.NET Framework 2.0'dan başlayarak, yeni işlevlerden yararlanmak için yöntemini ve XmlWriterSettings sınıfını XmlWriter.Create kullanarak örnekler oluşturmanızı XmlWriter öneririz.

WriteStartDocument()

XML bildirimini "1.0" sürümüyle yazar.

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

Özel durumlar

InvalidOperationException

Bu, oluşturucudan sonra çağrılan ilk yazma yöntemi değildir.

Örnekler

Aşağıdaki örnek, bir kitabı temsil eden bir XML dosyası yazar.

#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

Açıklamalar

Not

.NET Framework 2.0'dan başlayarak, yeni işlevlerden yararlanmak için yöntemini ve XmlWriterSettings sınıfını XmlWriter.Create kullanarak örnekler oluşturmanızı XmlWriter öneririz.

Belgenin kodlama düzeyi, yazarın nasıl uygulandığına göre belirlenir. Örneğin, oluşturucuda XmlTextWriter bir Encoding nesne belirtilirse bu, kodlama özniteliğinin değerini belirler. Bu yöntem tek başına bir öznitelik oluşturmaz.

WriteStartDocument çağrıldığında, yazıcı yazdığınız şeyin iyi biçimlendirilmiş bir XML belgesi olduğunu doğrular. Örneğin, XML bildiriminin ilk düğüm olduğunu, bir ve yalnızca bir kök düzeyi öğesinin mevcut olduğunu vb. denetler. Bu yöntem çağrılmazsa, yazıcı bir XML parçasının yazıldığını varsayar ve kök düzeyi kuralı uygulamaz.

Çağrılırsa ve yöntemi WriteProcessingInstruction başka bir XML bildirimi oluşturmak için kullanılırsaWriteStartDocument, bir özel durum oluşturulur.

Şunlara uygulanır

WriteStartDocument(Boolean)

XML bildirimini "1.0" sürümü ve tek başına özniteliğiyle yazar.

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

Parametreler

standalone
Boolean

ise true"standalone=yes" yazar; eğer ise false"standalone=no" yazar.

Özel durumlar

InvalidOperationException

Bu, oluşturucudan sonra çağrılan ilk yazma yöntemi değildir.

Açıklamalar

Not

.NET Framework 2.0'dan başlayarak, yeni işlevlerden yararlanmak için yöntemini ve XmlWriterSettings sınıfını XmlWriter.Create kullanarak örnekler oluşturmanızı XmlWriter öneririz.

Belgenin kodlama düzeyi, yazarın nasıl uygulandığına göre belirlenir. Örneğin, oluşturucuda XmlTextWriter bir Encoding nesne belirtilirse, kodlama özniteliğinin değerini belirler.

WriteStartDocument çağrıldığında, yazıcı yazdığınız şeyin iyi biçimlendirilmiş bir XML belgesi olduğunu doğrular. Örneğin, XML bildiriminin ilk düğüm olduğunu, bir ve yalnızca bir kök düzeyi öğesinin var olduğunu ve bu şekilde devam ettiğini denetler. Bu yöntem çağrılmazsa, yazıcı bir XML parçasının yazıldığını varsayar ve kök düzeyi kuralı uygulamaz.

Çağrılırsa ve yöntemi WriteProcessingInstruction başka bir XML bildirimi oluşturmak için kullanılırsaWriteStartDocument, bir özel durum oluşturulur.

Şunlara uygulanır