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

方法描述

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

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

public void SaveAs(
	string filename,
	ConfigurationSaveMode saveMode
)

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
filename System-String 要将配置文件保存到的路径和文件名。
saveMode System-Configuration-ConfigurationSaveMode 一个 ConfigurationSaveMode 值,该值用于确定要保存的属性值。
返回值 void

提示和注释

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

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

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

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


异常

异常 异常描述
ConfigurationErrorsException
  • 未能对该配置文件执行写入操作。
  • 配置文件已更改。

命名空间

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 系统要求。