Ist es möglich, XmlWriter.WriteEndDocument() zu verwenden, ohne XmlWriter.WriteStartDocument() aufzurufen

Question

Ich möchte den Grund hinter den XmlWriter.WriteStartDocument() und XmlWriter.WriteEndDocument() wissen.

In meinem Szenario Ich erstelle ein XML-Dokument mit einigen Daten in ihm, zum Beispiel:

XmlWriter xmlWriter = XmlWriter.Create(file); 

xmlWriter.WriteStartDocument(); 

// write xml elements and attributes... 

xmlWriter.WriteEndDocument(); 

xmlWriter.Flush(); 

Während der Serialisierung, XmlWriter keine Ausnahme wirft, wenn wir den Anruf zu xmlWriter.WriteStartDocument() überspringen und rufen Sie einfach xmlWriter.WriteEndDocument() bei der Ende.

Die unter Code-Schnipsel werfen keine Fehler oder eine Ausnahme:

XmlWriter xmlWriter = XmlWriter.Create(file); 

// write xml elements and attributes... 

xmlWriter.WriteEndDocument(); 

xmlWriter.Flush(); 

Wie ist das möglich? Und können Sie die Funktionalität von WriteStartDocument() und WriteEndDocument() erklären?

Answer 1

Per the documentation für WriteStartDocument, schreibt diese Methode die XML-Deklaration, die vor dem Stammelement erscheint ::

Wenn in einer abgeleiteten Klasse überschrieben, schreibt die XML-Deklaration.

Und pro the documentation für WriteEndDocument:

Wenn in einer abgeleiteten Klasse überschrieben, schließt alle geöffneten Elemente oder Attribute und stellt den Schriftsteller wieder in den Zustand Start.

Es gibt keine Erwähnung, dass das eine mit dem anderen zusammenhängt oder davon abhängig ist, und tatsächlich scheinen Ihre Experimente das zu beweisen.

Im Gegensatz zu anderen ähnlich benannten Methodenpaaren wie WriteStartElement und kann der Aufruf eines dieser ohne den anderen Sie nicht in einen Zustand bringen, in dem das Dokument ungültig ist. Trotzdem würde ich Ihnen raten, sie am Anfang und am Ende des Schreibens eines Dokuments anzurufen, da dies offensichtlich die Absicht der API ist.

Als Neben ist es selten, XmlReader und XmlWriter direkt so zu verwenden. Sie sind XML-APIs auf sehr niedriger Ebene. Ich würde vorschlagen, dass Sie LINQ to XML und XmlSerializer für die meisten Anwendungsfälle erkunden.