XmlTextWriter.XmlSpace Property

 
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.

Gets an XmlSpace representing the current xml:space scope.

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

public override XmlSpace XmlSpace { get; }

Property Value

Type: System.Xml.XmlSpace

An XmlSpace representing the current xml:space scope.

Value

Meaning

None

This is the default if no xml:space scope exists.

Default

The current scope is xml:space="default".

Preserve

The current scope is xml:space="preserve".

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 property allows one component to find out in what state another component has left the writer.

The following example uses the WriteWhitespace method to control how the file is formatted.

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

public class Sample
{  
  public static void Main()
  {
    // Create the writer.
    XmlTextWriter writer = null;
    writer = new XmlTextWriter ("ws.html", null);

    // Write an element (this one is the root).
    writer.WriteStartElement("p");

    // Write the xml:space attribute.
    writer.WriteAttributeString("xml", "space", null, "preserve");

    // Verify that xml:space is set properly.
    if (writer.XmlSpace == XmlSpace.Preserve)
      Console.WriteLine("xmlspace is correct!");

    // Write out the HTML elements.  Insert white space
    // between 'something' and 'Big'
    writer.WriteString("something");
    writer.WriteWhitespace("  ");
    writer.WriteElementString("b", "B");
    writer.WriteString("ig");

    // Write the root end element.
    writer.WriteEndElement();

    // Write the XML to file and close the writer.
    writer.Close();  
  }
}

.NET Framework
Available since 1.1
Return to top
Show: