Configuration.SaveAs Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Записывает параметры конфигурации, содержащиеся в данном объекте Configuration, в указанный файл конфигурации XML.
Перегрузки
SaveAs(String) |
Записывает параметры конфигурации, содержащиеся в данном объекте Configuration, в указанный файл конфигурации XML. |
SaveAs(String, ConfigurationSaveMode) |
Записывает параметры конфигурации, содержащиеся в данном объекте Configuration, в указанный файл конфигурации XML. |
SaveAs(String, ConfigurationSaveMode, Boolean) |
Записывает параметры конфигурации, содержащиеся в данном объекте Configuration, в указанный файл конфигурации XML. |
SaveAs(String)
- Исходный код:
- Configuration.cs
- Исходный код:
- Configuration.cs
- Исходный код:
- 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
Полное имя файла, в котором сохраняется файл конфигурации.
Исключения
Невозможно записать файл конфигурации.
-или-
Файл конфигурации был изменен.
Комментарии
Метод SaveAs сохраняет все параметры конфигурации, которые были изменены с момента создания этого Configuration объекта в новом файле.
Если файл конфигурации не существует в физическом расположении, представленном
FilePath будет создан новый файл конфигурации, содержащий все параметры, отличающиеся от унаследованной конфигурации.
Если файл конфигурации изменился с момента создания этого Configuration объекта, возникает ошибка во время выполнения.
Применяется к
SaveAs(String, ConfigurationSaveMode)
- Исходный код:
- Configuration.cs
- Исходный код:
- Configuration.cs
- Исходный код:
- 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, определяющее, какие значения свойств сохранять.
Исключения
Невозможно записать файл конфигурации.
-или-
Файл конфигурации был изменен.
Комментарии
Метод SaveAs сохраняет параметры конфигурации в объекте в Configuration новый файл на saveMode
основе параметра .
Если файл конфигурации не существует в физическом расположении, представленном свойством FilePath , будет создан новый файл конфигурации, содержащий параметры, отличающиеся от унаследованной конфигурации.
Если файл конфигурации изменился с момента создания этого Configuration объекта, возникает ошибка во время выполнения.
Применяется к
SaveAs(String, ConfigurationSaveMode, Boolean)
- Исходный код:
- Configuration.cs
- Исходный код:
- Configuration.cs
- Исходный код:
- 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
.
Исключения
Параметр 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 сохраняет параметры конфигурации в объекте в Configuration новый файл на saveMode
основе параметров и forceSaveAll
.
Если файл конфигурации не существует в физическом расположении, представленном свойством FilePath , будет создан новый файл конфигурации, содержащий параметры, отличающиеся от унаследованной конфигурации.
Если файл конфигурации изменился с момента создания этого Configuration объекта, возникает ошибка во время выполнения.