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.cs
- Исходный код:
- Configuration.cs
- Исходный код:
- 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.cs
- Исходный код:
- Configuration.cs
- Исходный код:
- 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.cs
- Исходный код:
- Configuration.cs
- Исходный код:
- 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 объекта, возникает ошибка во время выполнения.