This documentation is archived and is not being maintained.

XmlWriter.Flush Method

When overridden in a derived class, flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream.

Namespace:  System.Xml
Assembly:  System.Xml (in System.Xml.dll)

public abstract void Flush()

This is called instead of Close when you want to write more to the underlying stream without losing what is still in the buffer.

The following example writes two XML fragments.

using System;
using System.IO;
using System.Xml;

public class Sample {

  public static void Main() {

     // Create an XmlWriter to write XML fragments.
     XmlWriterSettings settings = new XmlWriterSettings();
     settings.ConformanceLevel = ConformanceLevel.Fragment;
     settings.Indent = true;
     XmlWriter writer = XmlWriter.Create(Console.Out, settings);

     // Write an XML fragment.
     writer.WriteStartElement("book");
     writer.WriteElementString("title", "Pride And Prejudice");
     writer.WriteEndElement();
     writer.Flush();

     // Write another XML fragment.
     writer.WriteStartElement("cd");
     writer.WriteElementString("title", "Americana");
     writer.WriteEndElement();
     writer.Flush();  

     // Close the writer.
     writer.Close();
  }
}
#using <mscorlib.dll>
#using <System.Xml.dll>
using namespace System;
using namespace System::IO;
using namespace System::Xml;

void main() {

     // Create an XmlWriter to write XML fragments.
     XmlWriterSettings* settings = new XmlWriterSettings();
     settings->ConformanceLevel = ConformanceLevel::Fragment;
     settings->Indent = true;
     XmlWriter* writer = XmlWriter::Create(Console::Out, settings);

     // Write an XML fragment.
     writer->WriteStartElement(S"book");
     writer->WriteElementString(S"title", S"Pride And Prejudice");
     writer->WriteEndElement();
     writer->Flush();

     // Write another XML fragment.
     writer->WriteStartElement(S"cd");
     writer->WriteElementString(S"title", S"Americana");
     writer->WriteEndElement();
     writer->Flush();  

     // Close the writer.
     writer->Close();
 };

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC, Xbox 360, Zune

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 3.5, 2.0, 1.0

XNA Framework

Supported in: 3.0, 2.0, 1.0
Show: