XmlTextWriter::Flush Method ()

 

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:
virtual void Flush() override

System_CAPS_noteNote

Starting with the .NET Framework 2.0, we recommend that you create XmlWriter instances by using the XmlWriter::Create method and the XmlWriterSettings class to take advantage of new functionality.

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 out two XML fragments.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   XmlTextWriter^ writer = gcnew XmlTextWriter( Console::Out );

   // Use indenting for readability
   writer->Formatting = Formatting::Indented;

   // 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();
}

.NET Framework
Available since 1.1
Return to top
Show: