Configuration.SaveAs Method (String, ConfigurationSaveMode)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Writes the configuration settings contained within this Configuration object to the specified XML configuration file.

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

public void SaveAs(
	string filename,
	ConfigurationSaveMode saveMode


Type: System.String

The path and file name to save the configuration file to.

Type: System.Configuration.ConfigurationSaveMode

A ConfigurationSaveMode value that determines which property values to save.

Exception Condition

The configuration file could not be written to.

- or -

The configuration file has changed.

The SaveAs method persists configuration settings in the Configuration object to a new file based on the saveMode parameter.

If a configuration file does not exist at the physical location represented by the FilePath property, a new configuration file will be created to contain any settings that are different from the inherited configuration..

If the configuration file has changed since this Configuration object was created, a run-time error occurs.

.NET Framework
Available since 2.0
Return to top