Configuration.SaveAs Метод

Определение

Пространство имен:

System.Configuration

Сборка:

System.Configuration.ConfigurationManager.dll

Пакет:

System.Configuration.ConfigurationManager v8.0.0

Записывает параметры конфигурации, содержащиеся в данном объекте Configuration, в указанный файл конфигурации XML.

Перегрузки

SaveAs(String)	Записывает параметры конфигурации, содержащиеся в данном объекте Configuration, в указанный файл конфигурации XML.
SaveAs(String, ConfigurationSaveMode)	Записывает параметры конфигурации, содержащиеся в данном объекте Configuration, в указанный файл конфигурации XML.
SaveAs(String, ConfigurationSaveMode, Boolean)	Записывает параметры конфигурации, содержащиеся в данном объекте Configuration, в указанный файл конфигурации XML.

SaveAs(String)

Исходный код:

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

Полное имя файла, в котором сохраняется файл конфигурации.

Исключения

ConfigurationErrorsException

Невозможно записать файл конфигурации.

-или-

Файл конфигурации был изменен.

Комментарии

Метод SaveAs сохраняет все параметры конфигурации, которые были изменены с момента создания этого Configuration объекта в новом файле.

Если файл конфигурации не существует в физическом расположении, представленном

FilePath будет создан новый файл конфигурации, содержащий все параметры, отличающиеся от унаследованной конфигурации.

Если файл конфигурации изменился с момента создания этого Configuration объекта, возникает ошибка во время выполнения.

SaveAs(String, ConfigurationSaveMode)

Исходный код:

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, определяющее, какие значения свойств сохранять.

Исключения

ConfigurationErrorsException

Невозможно записать файл конфигурации.

-или-

Файл конфигурации был изменен.

Комментарии

Метод SaveAs сохраняет параметры конфигурации в объекте в Configuration новый файл на saveMode основе параметра .

Если файл конфигурации не существует в физическом расположении, представленном свойством FilePath , будет создан новый файл конфигурации, содержащий параметры, отличающиеся от унаследованной конфигурации.

Если файл конфигурации изменился с момента создания этого Configuration объекта, возникает ошибка во время выполнения.

SaveAs(String, ConfigurationSaveMode, Boolean)

Исходный код:

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.

Исключения

ArgumentException

Параметр 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 объекта, возникает ошибка во время выполнения.