XmlWriter.WriteStartDocument Metode

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Saat ditimpa dalam kelas turunan, menulis deklarasi XML.

Overload

Nama	Deskripsi
WriteStartDocument(Boolean)	Saat ditimpa dalam kelas turunan, menulis deklarasi XML dengan versi "1.0" dan atribut mandiri.
WriteStartDocument()	Saat ditimpa dalam kelas turunan, menulis deklarasi XML dengan versi "1.0".

Keterangan

Untuk versi asinkron dari metode ini, lihat WriteStartDocumentAsync.

WriteStartDocument(Boolean)

Sumber:

XmlWriter.cs

Saat ditimpa dalam kelas turunan, menulis deklarasi XML dengan versi "1.0" dan atribut mandiri.

public:
 abstract void WriteStartDocument(bool standalone);

public abstract void WriteStartDocument(bool standalone);

abstract member WriteStartDocument : bool -> unit

Public MustOverride Sub WriteStartDocument (standalone As Boolean)

Parameter

standalone

Boolean

Jika true, ia menulis "standalone=yes"; jika false, ia menulis "standalone=no".

Pengecualian

InvalidOperationException

Ini bukan metode tulis pertama yang dipanggil setelah konstruktor.

-atau-

Metode XmlWriter dipanggil sebelum operasi asinkron sebelumnya selesai. Dalam hal ini, InvalidOperationException dilemparkan dengan pesan "Operasi asinkron sudah berlangsung."

Keterangan

Tingkat pengodean dokumen ditentukan oleh bagaimana penulis diimplementasikan. Misalnya, jika Encoding objek ditentukan dalam XmlTextWriter konstruktor, ini menentukan nilai atribut pengodean.

Ketika WriteStartDocument dipanggil, penulis memvalidasi bahwa apa yang Anda tulis adalah dokumen XML yang terbentuk dengan baik. Misalnya, ia memeriksa bahwa deklarasi XML adalah simpul pertama, bahwa satu dan hanya satu elemen tingkat akar yang ada, dan sebagainya. Jika metode ini tidak dipanggil, penulis mengasumsikan fragmen XML sedang ditulis dan tidak menerapkan aturan tingkat akar.

Jika WriteStartDocument telah dipanggil dan kemudian WriteProcessingInstruction metode digunakan untuk membuat deklarasi XML lain, pengecualian akan dilemparkan.

Untuk versi asinkron dari metode ini, lihat WriteStartDocumentAsync.

WriteStartDocument()

Sumber:

XmlWriter.cs

Saat ditimpa dalam kelas turunan, menulis deklarasi XML dengan versi "1.0".

public:
 abstract void WriteStartDocument();

public abstract void WriteStartDocument();

abstract member WriteStartDocument : unit -> unit

Public MustOverride Sub WriteStartDocument ()

Pengecualian

InvalidOperationException

Ini bukan metode tulis pertama yang dipanggil setelah konstruktor.

-atau-

Metode XmlWriter dipanggil sebelum operasi asinkron sebelumnya selesai. Dalam hal ini, InvalidOperationException dilemparkan dengan pesan "Operasi asinkron sudah berlangsung."

Keterangan

Tingkat pengodean dokumen ditentukan oleh bagaimana penulis diimplementasikan. Misalnya, jika Encoding objek ditentukan dalam XmlTextWriter konstruktor, ini menentukan nilai atribut pengodean. Metode ini tidak membuat atribut mandiri.

Ketika WriteStartDocument disebut penulis memvalidasi bahwa apa yang Anda tulis adalah dokumen XML yang terbentuk dengan baik. Misalnya, ia memeriksa bahwa deklarasi XML adalah simpul pertama, bahwa satu dan hanya satu elemen tingkat akar yang ada, dan sebagainya. Jika metode ini tidak dipanggil, penulis mengasumsikan fragmen XML sedang ditulis dan tidak menerapkan aturan tingkat akar.

Jika WriteStartDocument telah dipanggil dan kemudian WriteProcessingInstruction metode digunakan untuk membuat deklarasi XML lain, pengecualian akan dilemparkan.

Untuk versi asinkron dari metode ini, lihat WriteStartDocumentAsync.