Configuration.SaveAs 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
将此对象中包含的 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
- Source:
- Configuration.cs
- Source:
- Configuration.cs
- 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 -> unitPublic Sub SaveAs (filename As String)参数
- filename
- String
要保存配置文件的路径和文件名。
例外
注解
该方法 SaveAs 将保留自此 Configuration 对象创建到新文件后已修改的任何配置设置。
如果配置文件不存在于由 表示的物理位置
FilePath 属性，将创建一个新的配置文件，以包含与继承的配置不同的任何设置。
如果自创建此 Configuration 对象后配置文件已更改，则会发生运行时错误。
适用于
SaveAs(String, ConfigurationSaveMode)
- Source:
- Configuration.cs
- Source:
- Configuration.cs
- Source:
- Configuration.cs
- Source:
- Configuration.cs
- Source:
- Configuration.cs
- 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 -> unitPublic Sub SaveAs (filename As String, saveMode As ConfigurationSaveMode)参数
- filename
- String
要保存配置文件的路径和文件名。
- saveMode
- ConfigurationSaveMode
一个 ConfigurationSaveMode 值，用于确定要保存的属性值。
例外
注解
该方法SaveAs根据saveMode参数将对象中的Configuration配置设置保存到新文件中。
如果属性所表示 FilePath 的物理位置不存在配置文件，则会创建一个新的配置文件，以包含与继承的配置不同的任何设置。
如果自创建此 Configuration 对象后配置文件已更改，则会发生运行时错误。
适用于
SaveAs(String, ConfigurationSaveMode, Boolean)
- Source:
- Configuration.cs
- Source:
- Configuration.cs
- Source:
- Configuration.cs
- Source:
- Configuration.cs
- Source:
- Configuration.cs
- 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 -> unitPublic Sub SaveAs (filename As String, saveMode As ConfigurationSaveMode, forceSaveAll As Boolean)参数
- filename
- String
要保存配置文件的路径和文件名。
- saveMode
- ConfigurationSaveMode
一个 ConfigurationSaveMode 值，用于确定要保存的属性值。
- forceSaveAll
- Boolean
true 保存，即使配置未修改;否则，为 false.
例外
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 对象后配置文件已更改，则会发生运行时错误。
