Teilen über


XmlWriter.WriteStartDocument Methode

Definition

Schreibt beim Überschreiben in einer abgeleiteten Klasse die XML-Deklaration.

Überlädt

WriteStartDocument(Boolean)

Schreibt beim Überschreiben in einer abgeleiteten Klasse die XML-Deklaration mit der Version "1.0" und dem eigenständigen Attribut.

WriteStartDocument()

Schreibt beim Überschreiben in einer abgeleiteten Klasse die XML-Deklaration mit der Version "1.0".

Hinweise

Die asynchrone Version dieser Methode finden Sie unter WriteStartDocumentAsync.

WriteStartDocument(Boolean)

Schreibt beim Überschreiben in einer abgeleiteten Klasse die XML-Deklaration mit der Version "1.0" und dem eigenständigen Attribut.

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

Wenn true, wird "standalone=yes" geschrieben, wenn false, wird "standalone=no" geschrieben.

Ausnahmen

Dies ist nicht die erste nach dem Konstruktor aufgerufene Schreibmethode.

- oder -

Eine XmlWriter-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst.

Hinweise

Die Codierungsebene des Dokuments wird durch die Implementierung des Autors bestimmt. Wenn beispielsweise ein Encoding Objekt im XmlTextWriter Konstruktor angegeben wird, bestimmt dies den Wert des Codierungsattributes.

Wenn WriteStartDocument der Autor aufgerufen wird, überprüft der Autor, dass das, was Sie schreiben, ein gut gebildetes XML-Dokument ist. Sie überprüft beispielsweise, dass die XML-Deklaration der erste Knoten ist, dass ein und nur ein Stammelement vorhanden ist, usw. Wenn diese Methode nicht aufgerufen wird, wird vom Writer angenommen, dass ein XML-Fragment geschrieben wird und keine Stammebenenregeln angewendet werden.

Wenn WriteStartDocument die WriteProcessingInstruction Methode aufgerufen wurde und dann zum Erstellen einer anderen XML-Deklaration verwendet wird, wird eine Ausnahme ausgelöst.

Eine asynchrone Version dieser Methode finden Sie unter WriteStartDocumentAsync.

Gilt für

WriteStartDocument()

Schreibt beim Überschreiben in einer abgeleiteten Klasse die XML-Deklaration mit der Version "1.0".

public:
 abstract void WriteStartDocument();
public abstract void WriteStartDocument ();
abstract member WriteStartDocument : unit -> unit
Public MustOverride Sub WriteStartDocument ()

Ausnahmen

Dies ist nicht die erste nach dem Konstruktor aufgerufene Schreibmethode.

- oder -

Eine XmlWriter-Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall wird InvalidOperationException mit der Meldung „Es wird bereits ein asynchroner Vorgang ausgeführt“ ausgelöst.

Hinweise

Die Codierungsebene des Dokuments wird durch die Implementierung des Writers bestimmt. Wenn beispielsweise ein Encoding Objekt im XmlTextWriter Konstruktor angegeben wird, bestimmt dies den Wert des Codierungsattributes. Diese Methode erstellt kein eigenständiges Attribut.

Wenn WriteStartDocument der Writer aufgerufen wird, überprüft, ob es sich bei der Erstellung um ein gut gebildetes XML-Dokument handelt. Sie überprüft beispielsweise, ob die XML-Deklaration der erste Knoten ist, dass ein und nur ein Element auf Stammebene vorhanden ist usw. Wenn diese Methode nicht aufgerufen wird, geht der Writer davon aus, dass ein XML-Fragment geschrieben wird und keine Regeln auf Stammebene angewendet werden.

Wenn WriteStartDocument sie aufgerufen wurde und die WriteProcessingInstruction Methode zum Erstellen einer anderen XML-Deklaration verwendet wird, wird eine Ausnahme ausgelöst.

Eine asynchrone Version dieser Methode finden Sie unter WriteStartDocumentAsync.

Gilt für