Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

SaveOptions Enumeration

Specifies serialization options.

This enumeration has a FlagsAttribute attribute that allows a bitwise combination of its member values.

Namespace:  System.Xml.Linq
Assemblies:   System.Xml.XDocument (in System.Xml.XDocument.dll)
  System.Xml.Linq (in System.Xml.Linq.dll)

[FlagsAttribute]
public enum SaveOptions

Member nameDescription
Supported by the XNA FrameworkSupported by Portable Class LibraryDisableFormattingPreserve all insignificant white space while serializing.
Supported by the XNA FrameworkSupported by Portable Class LibraryNoneFormat (indent) the XML while serializing.
Supported by Portable Class LibraryOmitDuplicateNamespacesRemove the duplicate namespace declarations while serializing.

If you disable formatting when serializing, all insignificant white space in the XML tree is serialized as is. If you do not disable formatting, then all insignificant white space in the XML tree is discarded, and the XML is formatted (indented) as it is serialized.

This type allows you to control how LINQ to XML handles white space when serializing. For more information, see Preserving White Space while Loading or Parsing XML and Preserving White Space While Serializing.

The following example shows two ways to serialize. The first preserves insignificant white space in the XML tree. The second serializes the XElement with formatting.

string str;
XElement root = XElement.Parse(@"<Root> <Child> Text </Child> </Root>");

root.Save("Root.xml", SaveOptions.DisableFormatting);
str = File.ReadAllText("Root.xml");
Console.WriteLine(str);

Console.WriteLine("=====");

root.Save("Root.xml", SaveOptions.None);
str = File.ReadAllText("Root.xml");
Console.WriteLine(str);

This example produces the following output:

<?xml version="1.0" encoding="utf-8"?><Root><Child> Text </Child></Root>
=====
<?xml version="1.0" encoding="utf-8"?>
<Root>
  <Child> Text </Child>
</Root>

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0

.NET for Windows Phone apps

Supported in: Windows Phone 8.1, Windows Phone Silverlight 8.1, Windows Phone Silverlight 8

Portable Class Library

Supported in: Portable Class Library
Show:
© 2015 Microsoft