Configuration.Save Метод

Определение

Записывает параметры конфигурации, содержащиеся в данном объекте Configuration, в текущий файл конфигурации XML.Writes the configuration settings contained within this Configuration object to the current XML configuration file.

Перегрузки

Save()

Записывает параметры конфигурации, содержащиеся в данном объекте Configuration, в текущий файл конфигурации XML.Writes the configuration settings contained within this Configuration object to the current XML configuration file.

Save(ConfigurationSaveMode)

Записывает параметры конфигурации, содержащиеся в данном объекте Configuration, в текущий файл конфигурации XML.Writes the configuration settings contained within this Configuration object to the current XML configuration file.

Save(ConfigurationSaveMode, Boolean)

Записывает параметры конфигурации, содержащиеся в данном объекте Configuration, в текущий файл конфигурации XML.Writes the configuration settings contained within this Configuration object to the current XML configuration file.

Save()

Записывает параметры конфигурации, содержащиеся в данном объекте Configuration, в текущий файл конфигурации XML.Writes the configuration settings contained within this Configuration object to the current XML configuration file.

public:
 void Save();
public void Save ();
member this.Save : unit -> unit
Public Sub Save ()

Исключения

Невозможно записать файл конфигурации.The configuration file could not be written to.

-или--or-

Файл конфигурации был изменен.The configuration file has changed.

Комментарии

SaveМетод сохраняет все параметры конфигурации, измененные с момента Configuration создания этого объекта.The Save method persists any configuration settings that have been modified since this Configuration object was created. Если файл конфигурации не существует в физическом расположении, представленном FilePath свойством, будет создан новый файл конфигурации, содержащий параметры, которые отличаются от унаследованной конфигурации.If a configuration file does not exist at the physical location represented by the FilePath property, a new configuration file will be created to contain any settings that are different from the inherited configuration.

Если файл конфигурации был изменен с момента Configuration создания этого объекта, возникает ошибка времени выполнения.If the configuration file has changed since this Configuration object was created, a run-time error occurs.

Примечание

Если в списке ACL (список управления доступом) каталога, содержащего файл конфигурации, указан "Creator Owner", текущий пользователь Save становится новым владельцем файла и наследует разрешения, предоставленные пользователю "Создатель-владелец".When 'Creator Owner' is listed in the ACL (Access Control List) of the directory containing the configuration file, the current user of Save becomes the new owner of the file and inherits the permissions granted to 'Creator Owner'. Это приводит к повышению привилегий для текущего пользователя и удалению привилегий для предыдущего владельца.This results in an elevation of privileges for the current user and a removal of privileges for the previous owner.

Save(ConfigurationSaveMode)

Записывает параметры конфигурации, содержащиеся в данном объекте Configuration, в текущий файл конфигурации XML.Writes the configuration settings contained within this Configuration object to the current XML configuration file.

public:
 void Save(System::Configuration::ConfigurationSaveMode saveMode);
public:
 void Save(System::Configuration::ConfigurationSaveMode mode);
public void Save (System.Configuration.ConfigurationSaveMode saveMode);
public void Save (System.Configuration.ConfigurationSaveMode mode);
member this.Save : System.Configuration.ConfigurationSaveMode -> unit
member this.Save : System.Configuration.ConfigurationSaveMode -> unit
Public Sub Save (saveMode As ConfigurationSaveMode)
Public Sub Save (mode As ConfigurationSaveMode)

Параметры

saveModemode
ConfigurationSaveMode

Значение ConfigurationSaveMode, определяющее, какие значения свойств сохранять.A ConfigurationSaveMode value that determines which property values to save.

Исключения

Невозможно записать файл конфигурации.The configuration file could not be written to.

-или--or-

Файл конфигурации был изменен.The configuration file has changed.

Примеры

В следующем примере кода показано, как использовать Save метод для сохранения пользовательского раздела.The following code example demonstrates how to use the Save method to save a custom section.


// 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 параметра.The Save method persists configuration settings in the Configuration object based on the saveMode parameter.

Если файл конфигурации не существует в физическом расположении, представленном FilePath свойством, будет создан новый файл конфигурации, содержащий параметры, которые отличаются от унаследованной конфигурации.If a configuration file does not exist at the physical location represented by the FilePath property, a new configuration file will be created to contain any settings that are different from the inherited configuration.

Если файл конфигурации был изменен с момента Configuration создания этого объекта, возникает ошибка времени выполнения.If the configuration file has changed since this Configuration object was created, a run-time error occurs.

Примечание

Если в списке ACL (список управления доступом) каталога, содержащего файл конфигурации, указан "Creator Owner", текущий пользователь Save становится новым владельцем файла и наследует разрешения, предоставленные пользователю "Создатель-владелец".When 'Creator Owner' is listed in the ACL (Access Control List) of the directory containing the configuration file, the current user of Save becomes the new owner of the file and inherits the permissions granted to 'Creator Owner'. Это приводит к повышению привилегий для текущего пользователя и удалению привилегий для предыдущего владельца.This results in an elevation of privileges for the current user and a removal of privileges for the previous owner.

Save(ConfigurationSaveMode, Boolean)

Записывает параметры конфигурации, содержащиеся в данном объекте Configuration, в текущий файл конфигурации XML.Writes the configuration settings contained within this Configuration object to the current XML configuration file.

public:
 void Save(System::Configuration::ConfigurationSaveMode saveMode, bool forceSaveAll);
public:
 void Save(System::Configuration::ConfigurationSaveMode mode, bool forceUpdateAll);
public void Save (System.Configuration.ConfigurationSaveMode saveMode, bool forceSaveAll);
public void Save (System.Configuration.ConfigurationSaveMode mode, bool forceUpdateAll);
member this.Save : System.Configuration.ConfigurationSaveMode * bool -> unit
member this.Save : System.Configuration.ConfigurationSaveMode * bool -> unit
Public Sub Save (saveMode As ConfigurationSaveMode, forceSaveAll As Boolean)
Public Sub Save (mode As ConfigurationSaveMode, forceUpdateAll As Boolean)

Параметры

saveModemode
ConfigurationSaveMode

Значение ConfigurationSaveMode, определяющее, какие значения свойств сохранять.A ConfigurationSaveMode value that determines which property values to save.

forceSaveAllforceUpdateAll
Boolean

true для сохранения, даже если конфигурация не была изменена; в противном случае — false.true to save even if the configuration was not modified; otherwise, false.

Исключения

Невозможно записать файл конфигурации.The configuration file could not be written to.

-или--or-

Файл конфигурации был изменен.The configuration file has changed.

Комментарии

SaveМетод сохраняет параметры конфигурации в Configuration объекте на основе saveMode forceSaveAll параметров и.The Save method persists configuration settings in the Configuration object based on the saveMode and forceSaveAll parameters.

Если файл конфигурации не существует в физическом расположении, представленном FilePath свойством, будет создан новый файл конфигурации, содержащий параметры, которые отличаются от унаследованной конфигурации.If a configuration file does not exist at the physical location represented by the FilePath property, a new configuration file will be created to contain any settings that are different from the inherited configuration.

Если файл конфигурации был изменен с момента Configuration создания этого объекта, возникает ошибка времени выполнения.If the configuration file has changed since this Configuration object was created, a run-time error occurs.

Примечание

Если в списке ACL (список управления доступом) каталога, содержащего файл конфигурации, указан "Creator Owner", текущий пользователь Save становится новым владельцем файла и наследует разрешения, предоставленные пользователю "Создатель-владелец".When 'Creator Owner' is listed in the ACL (Access Control List) of the directory containing the configuration file, the current user of Save becomes the new owner of the file and inherits the permissions granted to 'Creator Owner'. Это приводит к повышению привилегий для текущего пользователя и удалению привилегий для предыдущего владельца.This results in an elevation of privileges for the current user and a removal of privileges for the previous owner.

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