XmlWriter.WriteStartDocument Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

System.Xml.ReaderWriter.dll

Sestavení:

System.Xml.dll

Sestavení:

netstandard.dll

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

Přetížení

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í verze této metody naleznete v tématu WriteStartDocumentAsync.

WriteStartDocument(Boolean)

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-

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

Poznámky

Úroveň kódování dokumentu určuje způsob implementace zápisu. Pokud Encoding je například 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 vytvořený dokument XML. Například zkontroluje, že deklarace XML je prvním uzlem, že jeden a pouze jeden element 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 byla volána a metoda WriteProcessingInstruction se používá k vytvoření další deklarace XML, vyvolá se výjimka.

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

WriteStartDocument()

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-

XmlWriter Metoda byla volána před dokončením předchozí asynchronní operace. V tomto případě InvalidOperationException se vyvolá 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.

Při WriteStartDocument zavolání zapisovač ověří, že to, co píšete, je dobře formátovaný dokument XML. Například zkontroluje, že deklarace XML je první uzel, že existuje jeden a pouze jeden element kořenové úrovně 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 byla volána a metoda WriteProcessingInstruction se používá k vytvoření další deklarace XML, vyvolá se výjimka.

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