XmlTextWriter.Flush Method ()

.NET Framework (current version)
 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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)

C#
C++
F#
VB
Copy 
public override void Flush()

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.

C#
C++
VB
Copy 
using System;
using System.IO;
using System.Xml;

public class Sample
{

  public static void Main()
  {
     XmlTextWriter writer = new 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: