Configuration.SaveAs 方法

定义

命名空间:

System.Configuration

程序集:

System.Configuration.ConfigurationManager.dll

包:

System.Configuration.ConfigurationManager v8.0.0

将包含在此 Configuration 对象中的配置设置写入指定的 XML 配置文件。

重载

SaveAs(String)	将包含在此 Configuration 对象中的配置设置写入指定的 XML 配置文件。
SaveAs(String, ConfigurationSaveMode)	将包含在此 Configuration 对象中的配置设置写入指定的 XML 配置文件。
SaveAs(String, ConfigurationSaveMode, Boolean)	将包含在此 Configuration 对象中的配置设置写入指定的 XML 配置文件。

SaveAs(String)

Source:

Configuration.cs

将包含在此 Configuration 对象中的配置设置写入指定的 XML 配置文件。

public:
 void SaveAs(System::String ^ filename);

public void SaveAs (string filename);

member this.SaveAs : string -> unit

Public Sub SaveAs (filename As String)

参数

filename

String

要将配置文件保存到的路径和文件名。

例外

ConfigurationErrorsException

无法对配置文件执行写入操作。

或

配置文件已更改。

注解

方法 SaveAs 将自创建此 Configuration 对象以来已修改的任何配置设置保存到新文件中。

如果配置文件不存在于 表示的物理位置

FilePath 属性，将创建一个新的配置文件，以包含与继承的配置不同的任何设置。

如果配置文件自创建此 Configuration 对象以来已更改，则会发生运行时错误。

SaveAs(String, ConfigurationSaveMode)

Source:

Configuration.cs

将包含在此 Configuration 对象中的配置设置写入指定的 XML 配置文件。

public:
 void SaveAs(System::String ^ filename, System::Configuration::ConfigurationSaveMode saveMode);

public void SaveAs (string filename, System.Configuration.ConfigurationSaveMode saveMode);

member this.SaveAs : string * System.Configuration.ConfigurationSaveMode -> unit

Public Sub SaveAs (filename As String, saveMode As ConfigurationSaveMode)

参数

filename

String

要将配置文件保存到的路径和文件名。

saveMode

ConfigurationSaveMode

一个 ConfigurationSaveMode 值，该值用于确定要保存的属性值。

例外

ConfigurationErrorsException

无法对配置文件执行写入操作。

或

配置文件已更改。

注解

方法SaveAs根据 saveMode 参数将 对象中的Configuration配置设置保存到新文件中。

如果配置文件不存在于 属性表示 FilePath 的物理位置，则会创建一个新的配置文件，以包含与继承的配置不同的任何设置。

如果配置文件自创建此 Configuration 对象以来已更改，则会发生运行时错误。

SaveAs(String, ConfigurationSaveMode, Boolean)

Source:

Configuration.cs

将包含在此 Configuration 对象中的配置设置写入指定的 XML 配置文件。

public:
 void SaveAs(System::String ^ filename, System::Configuration::ConfigurationSaveMode saveMode, bool forceSaveAll);

public void SaveAs (string filename, System.Configuration.ConfigurationSaveMode saveMode, bool forceSaveAll);

member this.SaveAs : string * System.Configuration.ConfigurationSaveMode * bool -> unit

Public Sub SaveAs (filename As String, saveMode As ConfigurationSaveMode, forceSaveAll As Boolean)

参数

filename

String

要将配置文件保存到的路径和文件名。

saveMode

ConfigurationSaveMode

一个 ConfigurationSaveMode 值，该值用于确定要保存的属性值。

forceSaveAll

Boolean

如果在未修改配置的情况下保存配置，则为 true；否则，为 false。

例外

ArgumentException

filename 为 null 或为空字符串 ("")。

示例

下面的代码示例演示如何使用 SaveAs 方法。

// Show how to use different modalities to save 
// a configuration file.
static void SaveConfigurationFile()
{
    try
    {

        // Get the current configuration file.
        System.Configuration.Configuration config =
                ConfigurationManager.OpenExeConfiguration(
                ConfigurationUserLevel.None) as Configuration;

        // Save the full configuration file and force save even if the file was not modified.
        config.SaveAs("MyConfigFull.config", ConfigurationSaveMode.Full, true);
        Console.WriteLine("Saved config file as MyConfigFull.config using the mode: {0}",
            ConfigurationSaveMode.Full.ToString());

        config =
                ConfigurationManager.OpenExeConfiguration(
                ConfigurationUserLevel.None) as Configuration;

        // Save only the part of the configuration file that was modified. 
        config.SaveAs("MyConfigModified.config", ConfigurationSaveMode.Modified, true);
        Console.WriteLine("Saved config file as MyConfigModified.config using the mode: {0}",
            ConfigurationSaveMode.Modified.ToString());

        config =
                ConfigurationManager.OpenExeConfiguration(
                ConfigurationUserLevel.None) as Configuration;

        // Save the full configuration file.
        config.SaveAs("MyConfigMinimal.config");
        Console.WriteLine("Saved config file as MyConfigMinimal.config using the mode: {0}",
            ConfigurationSaveMode.Minimal.ToString());
    }
    catch (ConfigurationErrorsException err)
    {
        Console.WriteLine("SaveConfigurationFile: {0}", err.ToString());
    }
}

' Show how to use different modalities to save 
' a configuration file.
Public Shared Sub SaveConfigurationFile()
    Try

        ' Get the current configuration file.
        Dim config As System.Configuration.Configuration = TryCast(ConfigurationManager.OpenExeConfiguration(ConfigurationUserLevel.None), Configuration)

        ' Save the full configuration file and force save even if the file was not modified.
        config.SaveAs("MyConfigFull.config", ConfigurationSaveMode.Full, True)
        Console.WriteLine("Saved config file as MyConfigFull.config using the mode: {0}", ConfigurationSaveMode.Full.ToString())

        config = TryCast(ConfigurationManager.OpenExeConfiguration(ConfigurationUserLevel.None), Configuration)

        ' Save only the part of the configuration file that was modified. 
        config.SaveAs("MyConfigModified.config", ConfigurationSaveMode.Modified, True)
        Console.WriteLine("Saved config file as MyConfigModified.config using the mode: {0}", ConfigurationSaveMode.Modified.ToString())

        config = TryCast(ConfigurationManager.OpenExeConfiguration(ConfigurationUserLevel.None), Configuration)

        ' Save the full configuration file.
        config.SaveAs("MyConfigMinimal.config")
        Console.WriteLine("Saved config file as MyConfigMinimal.config using the mode: {0}", ConfigurationSaveMode.Minimal.ToString())

    Catch err As ConfigurationErrorsException
        Console.WriteLine("SaveConfigurationFile: {0}", err.ToString())
    End Try

End Sub

注解

方法SaveAs根据 saveMode 和 forceSaveAll 参数将 对象中的Configuration配置设置保存到新文件中。

如果配置文件不存在于 属性表示 FilePath 的物理位置，则会创建一个新的配置文件，以包含与继承的配置不同的任何设置。

如果配置文件自创建此 Configuration 对象以来已更改，则会发生运行时错误。