SaveOptions Enum

Definition

Specifies serialization options.

This enumeration supports a bitwise combination of its member values.

public enum class SaveOptions
[System.Flags]
public enum SaveOptions
[<System.Flags>]
type SaveOptions = 
Public Enum SaveOptions
Inheritance
SaveOptions
Attributes

Fields

DisableFormatting 1

Preserve all insignificant white space while serializing.

None 0

Format (indent) the XML while serializing.

OmitDuplicateNamespaces 2

Remove the duplicate namespace declarations while serializing.

Examples

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);  
Dim str As String  
Dim root As XElement = <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>  

Remarks

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 Preserve white space while loading or parsing XML and Preserve white space while serializing.

Applies to

See also