XmlWriter.WriteStartDocument Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

Při přepsání v odvozené třídě zapíše deklaraci XML.

Přetížení

Name	Description
WriteStartDocument(Boolean)	Při přepsání v odvozené třídě zapíše deklaraci XML s verzí 1.0 a samostatným atributem.
WriteStartDocument()	Při přepsání v odvozené třídě zapíše deklaraci XML s verzí "1.0".

Poznámky

Asynchronní verzi této metody naleznete v tématu WriteStartDocumentAsync.

WriteStartDocument(Boolean)

Zdroj:

XmlWriter.cs

Při přepsání v odvozené třídě zapíše deklaraci XML s verzí 1.0 a samostatným atributem.

public:
 abstract void WriteStartDocument(bool standalone);

public abstract void WriteStartDocument(bool standalone);

abstract member WriteStartDocument : bool -> unit

Public MustOverride Sub WriteStartDocument (standalone As Boolean)

Parametry

standalone

Boolean

Pokud true, zapíše "standalone=yes"; pokud false, zapíše "standalone=no".

Výjimky

InvalidOperationException

Nejedná se o první metodu zápisu volanou po konstruktoru.

nebo

Před XmlWriter dokončením předchozí asynchronní operace byla volána metoda. V tomto případě InvalidOperationException je vyvolán zpráva "Asynchronní operace už probíhá".

Poznámky

Úroveň kódování dokumentu určuje způsob implementace zapisovače. Pokud je například Encoding objekt zadán v konstruktoru XmlTextWriter , určuje hodnotu atributu kódování.

Když WriteStartDocument je volána, zapisovač ověří, že to, co píšete, je dobře formátovaný dokument XML. Například zkontroluje, že deklarace XML je první uzel, že jeden a pouze jeden prvek kořenové úrovně existuje atd. Pokud tato metoda není volána, zapisovač předpokládá, že se zapisuje fragment XML a nepoužívá žádná pravidla kořenové úrovně.

Pokud WriteStartDocument byl volán a pak WriteProcessingInstruction se metoda používá k vytvoření další deklarace XML, vyvolá se výjimka.

Asynchronní verzi této metody naleznete v tématu WriteStartDocumentAsync.

WriteStartDocument()

Zdroj:

XmlWriter.cs

Při přepsání v odvozené třídě zapíše deklaraci XML s verzí "1.0".

public:
 abstract void WriteStartDocument();

public abstract void WriteStartDocument();

abstract member WriteStartDocument : unit -> unit

Public MustOverride Sub WriteStartDocument ()

Výjimky

InvalidOperationException

Nejedná se o první metodu zápisu volanou po konstruktoru.

nebo

Před XmlWriter dokončením předchozí asynchronní operace byla volána metoda. V tomto případě InvalidOperationException je vyvolán zpráva "Asynchronní operace už probíhá".

Poznámky

Úroveň kódování dokumentu určuje způsob implementace zapisovače. Pokud je například Encoding objekt zadán v konstruktoru XmlTextWriter , určuje hodnotu atributu kódování. Tato metoda nevytvoří samostatný atribut.

Když WriteStartDocument se zapisovač nazývá, ověří, že to, co píšete, je dobře formátovaný dokument XML. Například zkontroluje, že deklarace XML je první uzel, že jeden a pouze jeden prvek kořenové úrovně existuje atd. Pokud tato metoda není volána, zapisovač předpokládá, že se zapisuje fragment XML a nepoužívá žádná pravidla kořenové úrovně.

Pokud WriteStartDocument byl volán a pak WriteProcessingInstruction se metoda používá k vytvoření další deklarace XML, vyvolá se výjimka.

Asynchronní verzi této metody naleznete v tématu WriteStartDocumentAsync.