通过

Configuration.SaveAs 方法

  • 参考

定义

命名空间:
System.Configuration
程序集:
System.Configuration.ConfigurationManager.dll
程序集:
System.Configuration.dll
包:
System.Configuration.ConfigurationManager v6.0.0
包:
System.Configuration.ConfigurationManager v7.0.0
包:
System.Configuration.ConfigurationManager v8.0.0
包:
System.Configuration.ConfigurationManager v9.0.0-preview.2.24128.5

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

重载

SaveAs(String)

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

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

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

SaveAs(String)

Source:
Configuration.cs
Source:
Configuration.cs
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
Source:
Configuration.cs
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
Source:
Configuration.cs
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 对象以来已更改，则会发生运行时错误。

适用于