SaveOptions Enum
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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
- Attributes
Fields
| Name | Value | Description |
|---|---|---|
| None | 0 | Format (indent) the XML while serializing. |
| DisableFormatting | 1 | Preserve all insignificant white space 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.
