Configuration::SaveAs Method (String^, ConfigurationSaveMode, Boolean)
Writes the configuration settings contained within this Configuration object to the specified XML configuration file.
Assembly: System.Configuration (in System.Configuration.dll)
public: void SaveAs( String^ filename, ConfigurationSaveMode saveMode, bool forceSaveAll )
Parameters
- filename
-
Type:
System::String^
The path and file name to save the configuration file to.
- saveMode
-
Type:
System.Configuration::ConfigurationSaveMode
A ConfigurationSaveMode value that determines which property values to save.
- forceSaveAll
-
Type:
System::Boolean
true to save even if the configuration was not modified; otherwise, false.
| Exception | Condition |
|---|---|
| ArgumentException | filename is null or an empty string (""). |
The SaveAs method persists configuration settings in the Configuration object to a new file based on the saveMode and forceSaveAll parameters.
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.
Available since 2.0