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.
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird die XML-Deklaration geschrieben.
Überlädt
| Name | Beschreibung |
|---|---|
| WriteStartDocument(Boolean) |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird die XML-Deklaration mit der Version "1.0" und dem eigenständigen Attribut geschrieben. |
| WriteStartDocument() |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird die XML-Deklaration mit der Version "1.0" geschrieben. |
Hinweise
Die asynchrone Version dieser Methode finden Sie unter WriteStartDocumentAsync.
WriteStartDocument(Boolean)
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird die XML-Deklaration mit der Version "1.0" und dem eigenständigen Attribut geschrieben.
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, schreibt er "standalone=yes"; if false, it writes "standalone=no".
Ausnahmen
Dies ist nicht die erste Schreibmethode, die nach dem Konstruktor aufgerufen wird.
-oder-
Eine XmlWriter Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall InvalidOperationException wird die Meldung "Ein asynchroner Vorgang wird bereits 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 ist, bestimmt dies den Wert des Codierungsattributs.
Wenn WriteStartDocument der Writer aufgerufen wird, überprüft der Writer, dass es sich bei dem, was Sie schreiben, um ein wohlgeformtes XML-Dokument handelt. Beispielsweise wird überprüft, ob es sich bei der XML-Deklaration um den ersten Knoten handelt, ob 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 die Methode aufgerufen wurde und dann WriteProcessingInstruction zum Erstellen einer anderen XML-Deklaration verwendet wird, wird eine Ausnahme ausgelöst.
Die asynchrone Version dieser Methode finden Sie unter WriteStartDocumentAsync.
Gilt für:
WriteStartDocument()
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
- Quelle:
- XmlWriter.cs
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird die XML-Deklaration mit der Version "1.0" geschrieben.
public:
abstract void WriteStartDocument();public abstract void WriteStartDocument();abstract member WriteStartDocument : unit -> unitPublic MustOverride Sub WriteStartDocument ()Ausnahmen
Dies ist nicht die erste Schreibmethode, die nach dem Konstruktor aufgerufen wird.
-oder-
Eine XmlWriter Methode wurde aufgerufen, bevor ein vorheriger asynchroner Vorgang abgeschlossen wurde. In diesem Fall InvalidOperationException wird die Meldung "Ein asynchroner Vorgang wird bereits 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 ist, bestimmt dies den Wert des Codierungsattributs. Diese Methode erstellt kein eigenständiges Attribut.
Beim WriteStartDocument Aufruf des Writers wird überprüft, ob es sich bei Dem, was Sie schreiben, um ein wohlgeformtes XML-Dokument handelt. Beispielsweise wird überprüft, ob es sich bei der XML-Deklaration um den ersten Knoten handelt, ob 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 die Methode aufgerufen wurde und dann WriteProcessingInstruction zum Erstellen einer anderen XML-Deklaration verwendet wird, wird eine Ausnahme ausgelöst.
Die asynchrone Version dieser Methode finden Sie unter WriteStartDocumentAsync.
