Configuration.SaveAs Метод

Ссылка

Определение

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

Сборка:: System.Configuration.ConfigurationManager.dll

Сборка:: System.Configuration.dll

Пакет:: System.Configuration.ConfigurationManager v6.0.0

Пакет:: System.Configuration.ConfigurationManager v7.0.0

Пакет:: System.Configuration.ConfigurationManager v8.0.0

Пакет:: System.Configuration.ConfigurationManager v9.0.0-preview.2.24128.5

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Записывает параметры конфигурации, содержащиеся в данном объекте 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

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

Исключения

ConfigurationErrorsException

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

-или-

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

Применяется к

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

Исключения

ConfigurationErrorsException

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

-или-

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

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

Применяется к

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.

Исключения

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

Применяется к

Поделиться через

Configuration.SaveAs Метод

Определение

Перегрузки

SaveAs(String)

Параметры

Исключения

Комментарии

Применяется к

SaveAs(String, ConfigurationSaveMode)

Параметры

Исключения

Комментарии

Применяется к

SaveAs(String, ConfigurationSaveMode, Boolean)

Параметры

Исключения

Примеры

Комментарии

Применяется к

Дополнительные ресурсы