Configuration 类

System.Configuration.Configuration.SaveAs 方法 (String, ConfigurationSaveMode, Boolean)

上一篇：System.Configuration.Configuration.SaveAs(String,ConfigurationSaveMode) 方法下一篇：system.configuration.configurationsavemode 类

方法描述

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

语法定义(C# System.Configuration.Configuration.SaveAs 方法 (String, ConfigurationSaveMode, Boolean) 的用法)

public void SaveAs(
	string filename,
	ConfigurationSaveMode saveMode,
	bool forceSaveAll
)

参数/返回值

参数值/返回值	参数类型/返回类型	参数描述/返回描述
filename	System-String	要将配置文件保存到的路径和文件名。
saveMode	System-Configuration-ConfigurationSaveMode	一个 ConfigurationSaveMode 值，该值用于确定要保存的属性值。
forceSaveAll	System-Boolean	如果在未修改配置的情况下保存配置，则为 true；否则，为 false。
返回值	void

提示和注释

The SaveAs 方法基于 saveMode 参数和 forceSaveAll 参数将 Configuration 对象中的配置设置保持到一个新的文件中。

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

如果自从此 Configuration 对象创建以后配置文件发生了更改，则将发生运行时错误。

System.Configuration.Configuration.SaveAs 方法 (String, ConfigurationSaveMode, Boolean)例子

下面的代码示例说明如何使用 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());
    }

}

异常

异常	异常描述
ArgumentException	filename 为空或空字符串 ("")。

命名空间

namespace: System.Configuration

程序集: System.Configuration（在 System.Configuration.dll 中）

版本信息

.NET Framework 受以下版本支持：4、3.5、3.0、2.0 .NET Framework Client Profile 受以下版本支持：4、3.5 SP1

适用平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008（不支持服务器核心）, Windows Server 2008 R2（支持 SP1 或更高版本的服务器核心）, Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表，请参见.NET Framework 系统要求。