SaveOptions SaveOptions SaveOptions SaveOptions Enum

Definition

Specifies serialization options.

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

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

Fields

DisableFormatting DisableFormatting DisableFormatting DisableFormatting 1

Preserve all insignificant white space while serializing.

None None None None 0

Format (indent) the XML while serializing.

OmitDuplicateNamespaces OmitDuplicateNamespaces OmitDuplicateNamespaces 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 Preserving White Space while Loading or Parsing XML and Preserving White Space While Serializing.

Applies to

See also