XmlWriter.WriteStartDocument Metoda

Definicja

Przestrzeń nazw:

System.Xml

Zestaw:

System.Xml.ReaderWriter.dll

Zestaw:

System.Xml.dll

Zestaw:

netstandard.dll

Po zastąpieniu w klasie pochodnej zapisuje deklarację XML.

Przeciążenia

WriteStartDocument(Boolean)	Gdy zastąpisz klasę pochodną, zapisuje deklarację XML z wersją "1.0" i atrybutem autonomicznym.
WriteStartDocument()	Podczas zastępowania w klasie pochodnej zapisuje deklarację XML z wersją "1.0".

Uwagi

Aby uzyskać asynchroniczną wersję tej metody, zobacz WriteStartDocumentAsync.

WriteStartDocument(Boolean)

Gdy zastąpisz klasę pochodną, zapisuje deklarację XML z wersją "1.0" i atrybutem autonomicznym.

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

Jeśli trueprogram zapisuje ciąg "standalone=yes"; jeśli false, zapisuje ciąg "standalone=no".

Wyjątki

InvalidOperationException

Nie jest to pierwsza metoda zapisu wywoływana po konstruktorze.

-lub-

Metoda XmlWriter została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W tym przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku".

Uwagi

Poziom kodowania dokumentu zależy od sposobu implementacji składnika zapisywania. Jeśli na przykład Encoding obiekt jest określony w konstruktorze XmlTextWriter , określa wartość atrybutu kodowania.

Po WriteStartDocument wywołaniu moduł zapisywania sprawdza, czy to, co piszesz, jest dobrze sformułowanym dokumentem XML. Na przykład sprawdza, czy deklaracja XML jest pierwszym węzłem, że jeden i tylko jeden element poziomu głównego istnieje itd. Jeśli ta metoda nie jest wywoływana, składnik zapisywania zakłada, że fragment XML jest zapisywany i nie stosuje żadnych reguł poziomu głównego.

Jeśli WriteStartDocument została wywołana, a następnie WriteProcessingInstruction metoda jest używana do utworzenia innej deklaracji XML, zostanie zgłoszony wyjątek.

Aby uzyskać asynchroniczną wersję tej metody, zobacz WriteStartDocumentAsync.

WriteStartDocument()

Podczas zastępowania w klasie pochodnej zapisuje deklarację XML z wersją "1.0".

public:
 abstract void WriteStartDocument();

public abstract void WriteStartDocument ();

abstract member WriteStartDocument : unit -> unit

Public MustOverride Sub WriteStartDocument ()

Wyjątki

InvalidOperationException

Nie jest to pierwsza metoda zapisu wywoływana po konstruktorze.

-lub-

Metoda XmlWriter została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W tym przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku".

Uwagi

Poziom kodowania dokumentu zależy od sposobu implementacji składnika zapisywania. Jeśli na przykład Encoding obiekt jest określony w konstruktorze XmlTextWriter , określa wartość atrybutu kodowania. Ta metoda nie tworzy atrybutu autonomicznego.

Gdy WriteStartDocument jest wywoływany składnik zapisywania, sprawdza, czy to, co piszesz, jest poprawnie sformułowanym dokumentem XML. Na przykład sprawdza, czy deklaracja XML jest pierwszym węzłem, że jeden i tylko jeden element poziomu głównego istnieje itd. Jeśli ta metoda nie zostanie wywołana, moduł zapisujący zakłada, że fragment XML jest zapisywany i nie stosuje żadnych reguł poziomu głównego.

Jeśli WriteStartDocument została wywołana, a następnie WriteProcessingInstruction metoda zostanie użyta do utworzenia innej deklaracji XML, zostanie zgłoszony wyjątek.

Aby uzyskać asynchroniczną wersję tej metody, zobacz WriteStartDocumentAsync.