XmlWriter.WriteStartDocument Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 -> unitPublic 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 -> unitPublic 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.