XmlWriter.WriteStartDocument Metódus

Definíció

Névtér:

System.Xml

Szerelvények:

netstandard.dll, System.Xml.ReaderWriter.dll

Ha felül van bírálva egy származtatott osztályban, megírja az XML-deklarációt.

Túlterhelések

Név	Description
WriteStartDocument(Boolean)	Ha egy származtatott osztályban felül van bírálva, az XML-deklarációt az "1.0" verzióval és az önálló attribútummal írja.
WriteStartDocument()	Ha egy származtatott osztályban felül van bírálva, az XML-deklarációt az "1.0" verzióval írja.

Megjegyzések

A metódus aszinkron verziójáról lásd WriteStartDocumentAsync: .

WriteStartDocument(Boolean)

Forrás:

XmlWriter.cs

Ha egy származtatott osztályban felül van bírálva, az XML-deklarációt az "1.0" verzióval és az önálló attribútummal írja.

public:
 abstract void WriteStartDocument(bool standalone);

public abstract void WriteStartDocument(bool standalone);

abstract member WriteStartDocument : bool -> unit

Public MustOverride 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.

-vagy-

Egy XmlWriter metódust hívtak meg, mielőtt egy korábbi aszinkron művelet befejeződött. Ebben az esetben InvalidOperationException a "Aszinkron művelet már folyamatban van" üzenet jelenik meg.

Megjegyzések

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 a rendszer meghívja, az író 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, hogy létezik-e egy és csak egy gyökérszintű elem, é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 küld.

A metódus aszinkron verziójáról lásd WriteStartDocumentAsync: .

WriteStartDocument()

Forrás:

XmlWriter.cs

Ha egy származtatott osztályban felül van bírálva, az XML-deklarációt az "1.0" verzióval írja.

public:
 abstract void WriteStartDocument();

public abstract void WriteStartDocument();

abstract member WriteStartDocument : unit -> unit

Public MustOverride Sub WriteStartDocument ()

Kivételek

InvalidOperationException

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

-vagy-

Egy XmlWriter metódust hívtak meg, mielőtt egy korábbi aszinkron művelet befejeződött. Ebben az esetben InvalidOperationException a "Aszinkron művelet már folyamatban van" üzenet jelenik meg.

Megjegyzések

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, hogy létezik-e egy és csak egy gyökérszintű elem, é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 küld.

A metódus aszinkron verziójáról lásd WriteStartDocumentAsync: .