Configuration.Save Метод

Определение

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

System.Configuration

Сборка:

System.Configuration.ConfigurationManager.dll

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

Перегрузки

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

Save()

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

Configuration.cs

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

public:
 void Save();

public void Save();

member this.Save : unit -> unit

Public Sub Save ()

Исключения

ConfigurationErrorsException

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

–или–

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

Комментарии

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

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

Замечание

Когда в списке ACL (список управления доступом) каталога, содержащего файл конфигурации, текущий пользователь Save становится новым владельцем файла и наследует разрешения, предоставленные владельцу Создателя. Это приводит к повышению привилегий для текущего пользователя и удалению привилегий для предыдущего владельца.

Save(ConfigurationSaveMode)

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

Configuration.cs

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

public:
 void Save(System::Configuration::ConfigurationSaveMode saveMode);

public void Save(System.Configuration.ConfigurationSaveMode saveMode);

member this.Save : System.Configuration.ConfigurationSaveMode -> unit

Public Sub Save (saveMode As ConfigurationSaveMode)

Параметры

saveMode

ConfigurationSaveMode

Значение, определяющее ConfigurationSaveMode , какие значения свойств необходимо сохранить.

Исключения

ConfigurationErrorsException

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

–или–

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

Примеры

В следующем примере кода показано, как использовать Save метод для сохранения пользовательского раздела.

// Show how to create an instance of the Configuration class
// that represents this application configuration file.  
static void CreateConfigurationFile()
{
    try
    {

        // Create a custom configuration section.
        CustomSection customSection = new CustomSection();

        // Get the current configuration file.
        System.Configuration.Configuration config =
                ConfigurationManager.OpenExeConfiguration(
                ConfigurationUserLevel.None);

        // Create the custom section entry  
        // in <configSections> group and the 
        // related target section in <configuration>.
        if (config.Sections["CustomSection"] == null)
        {
            config.Sections.Add("CustomSection", customSection);
        }

        // Create and add an entry to appSettings section.
        
        string conStringname="LocalSqlServer";
        string conString = @"data source=.\SQLEXPRESS;Integrated Security=SSPI;AttachDBFilename=|DataDirectory|aspnetdb.mdf;User Instance=true";
        string providerName="System.Data.SqlClient";

        ConnectionStringSettings connStrSettings = new ConnectionStringSettings();
        connStrSettings.Name = conStringname;
        connStrSettings.ConnectionString= conString;
        connStrSettings.ProviderName = providerName;

        config.ConnectionStrings.ConnectionStrings.Add(connStrSettings);
        
        // Add an entry to appSettings section.
        int appStgCnt =
            ConfigurationManager.AppSettings.Count;
        string newKey = "NewKey" + appStgCnt.ToString();

        string newValue = DateTime.Now.ToLongDateString() +
          " " + DateTime.Now.ToLongTimeString();

        config.AppSettings.Settings.Add(newKey, newValue);

        // Save the configuration file.
        customSection.SectionInformation.ForceSave = true;
        config.Save(ConfigurationSaveMode.Full);

        Console.WriteLine("Created configuration file: {0}",
            config.FilePath);
    }
    catch (ConfigurationErrorsException err)
    {
        Console.WriteLine("CreateConfigurationFile: {0}", err.ToString());
    }
}

' Show how to create an instance of the Configuration class
' that represents this application configuration file.  
Public Shared Sub CreateConfigurationFile()
    Try

        ' Create a custom configuration section.
        Dim customSection As New CustomSection()

        ' Get the current configuration file.
        Dim config As System.Configuration.Configuration = ConfigurationManager.OpenExeConfiguration(ConfigurationUserLevel.None)

        ' Create the section entry  
        ' in <configSections> and the 
        ' related target section in <configuration>.
        If config.Sections("CustomSection") Is Nothing Then
            config.Sections.Add("CustomSection", customSection)
        End If

        ' Create and add an entry to appSettings section.

        Dim conStringname As String = "LocalSqlServer"
        Dim conString As String = "data source=.\SQLEXPRESS;Integrated Security=SSPI;AttachDBFilename=|DataDirectory|aspnetdb.mdf;User Instance=true"
        Dim providerName As String = "System.Data.SqlClient"

        Dim connStrSettings As New ConnectionStringSettings()
        connStrSettings.Name = conStringname
        connStrSettings.ConnectionString = conString
        connStrSettings.ProviderName = providerName

        config.ConnectionStrings.ConnectionStrings.Add(connStrSettings)

        ' Add an entry to appSettings section.
        Dim appStgCnt As Integer = ConfigurationManager.AppSettings.Count
        Dim newKey As String = "NewKey" & appStgCnt.ToString()

        Dim newValue As String = Date.Now.ToLongDateString() & " " & Date.Now.ToLongTimeString()

        config.AppSettings.Settings.Add(newKey, newValue)

        ' Save the configuration file.
        customSection.SectionInformation.ForceSave = True
        config.Save(ConfigurationSaveMode.Full)

        Console.WriteLine("Created configuration file: {0}", config.FilePath)

    Catch err As ConfigurationErrorsException
        Console.WriteLine("CreateConfigurationFile: {0}", err.ToString())
    End Try

End Sub

Комментарии

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

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

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

Замечание

Когда в списке ACL (список управления доступом) каталога, содержащего файл конфигурации, текущий пользователь Save становится новым владельцем файла и наследует разрешения, предоставленные владельцу Создателя. Это приводит к повышению привилегий для текущего пользователя и удалению привилегий для предыдущего владельца.

Save(ConfigurationSaveMode, Boolean)

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

Configuration.cs

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

public:
 void Save(System::Configuration::ConfigurationSaveMode saveMode, bool forceSaveAll);

public void Save(System.Configuration.ConfigurationSaveMode saveMode, bool forceSaveAll);

member this.Save : System.Configuration.ConfigurationSaveMode * bool -> unit

Public Sub Save (saveMode As ConfigurationSaveMode, forceSaveAll As Boolean)

Параметры

saveMode

ConfigurationSaveMode

Значение, определяющее ConfigurationSaveMode , какие значения свойств необходимо сохранить.

forceSaveAll

Boolean

true значение для сохранения, даже если конфигурация не была изменена; falseв противном случае .

Исключения

ConfigurationErrorsException

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

–или–

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

Комментарии

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

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

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

Замечание

Когда в списке ACL (список управления доступом) каталога, содержащего файл конфигурации, текущий пользователь Save становится новым владельцем файла и наследует разрешения, предоставленные владельцу Создателя. Это приводит к повышению привилегий для текущего пользователя и удалению привилегий для предыдущего владельца.