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

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