Configuration.Save メソッド

定義

名前空間:

System.Configuration

アセンブリ:

System.Configuration.ConfigurationManager.dll

パッケージ:

System.Configuration.ConfigurationManager v8.0.0

この Configuration オブジェクトに格納されている構成設定を、現在の XML 構成ファイルに書き込みます。

オーバーロード

Save()	この Configuration オブジェクトに格納されている構成設定を、現在の XML 構成ファイルに書き込みます。
Save(ConfigurationSaveMode)	この Configuration オブジェクトに格納されている構成設定を、現在の XML 構成ファイルに書き込みます。
Save(ConfigurationSaveMode, Boolean)	この Configuration オブジェクトに格納されている構成設定を、現在の XML 構成ファイルに書き込みます。

Save()

ソース:

Configuration.cs

この Configuration オブジェクトに格納されている構成設定を、現在の XML 構成ファイルに書き込みます。

C#

public void Save ();

例外

ConfigurationErrorsException

構成ファイルに書き込めませんでした。

または

構成ファイルが変更されています。

注釈

メソッドは Save 、この Configuration オブジェクトの作成後に変更されたすべての構成設定を保持します。 プロパティによって表される物理的な場所に構成ファイルが存在しない場合は、継承された FilePath 構成とは異なる設定を含む新しい構成ファイルが作成されます。

この Configuration オブジェクトの作成後に構成ファイルが変更された場合は、実行時エラーが発生します。

注意

構成ファイルを含むディレクトリの ACL (Access Control リスト) に 'Creator Owner' が表示されると、 の現在のSaveユーザーがファイルの新しい所有者になり、'Creator Owner' に付与されたアクセス許可が継承されます。 これにより、現在のユーザーの特権が昇格され、前の所有者の特権が削除されます。

Save(ConfigurationSaveMode)

ソース:

Configuration.cs

この Configuration オブジェクトに格納されている構成設定を、現在の XML 構成ファイルに書き込みます。

C#

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

パラメーター

saveMode

ConfigurationSaveMode

保存するプロパティ値を決定する ConfigurationSaveMode 値。

例外

ConfigurationErrorsException

構成ファイルに書き込めませんでした。

または

構成ファイルが変更されています。

例

次のコード例では、 メソッドを使用 Save してカスタム セクションを保存する方法を示します。

C#

// 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());
    }
}

注釈

メソッドは Save 、 パラメーターに基づいてオブジェクトの Configuration 構成設定を saveMode 保持します。

プロパティによって表される物理的な場所に構成ファイルが存在しない場合は、継承された FilePath 構成とは異なる設定を含む新しい構成ファイルが作成されます。

この Configuration オブジェクトの作成後に構成ファイルが変更された場合は、実行時エラーが発生します。

注意

構成ファイルを含むディレクトリの ACL (Access Control リスト) に 'Creator Owner' が表示されると、 の現在のSaveユーザーがファイルの新しい所有者になり、'Creator Owner' に付与されたアクセス許可が継承されます。 これにより、現在のユーザーの特権が昇格され、前の所有者の特権が削除されます。

Save(ConfigurationSaveMode, Boolean)

ソース:

Configuration.cs

この Configuration オブジェクトに格納されている構成設定を、現在の XML 構成ファイルに書き込みます。

C#

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

パラメーター

saveMode

ConfigurationSaveMode

保存するプロパティ値を決定する ConfigurationSaveMode 値。

forceSaveAll

Boolean

構成が変更されていなくても保存する場合は true。それ以外の場合は false。

例外

ConfigurationErrorsException

構成ファイルに書き込めませんでした。

または

構成ファイルが変更されています。

注釈

メソッドはSave、 パラメーターと forceSaveAll パラメーターにConfiguration基づいて、オブジェクトの構成設定をsaveMode保持します。

プロパティによって表される物理的な場所に構成ファイルが存在しない場合は、継承された FilePath 構成とは異なる設定を含む新しい構成ファイルが作成されます。

この Configuration オブジェクトの作成後に構成ファイルが変更された場合は、実行時エラーが発生します。

注意

構成ファイルを含むディレクトリの ACL (Access Control リスト) に 'Creator Owner' が表示されると、 の現在のSaveユーザーがファイルの新しい所有者になり、'Creator Owner' に付与されたアクセス許可が継承されます。 これにより、現在のユーザーの特権が昇格され、前の所有者の特権が削除されます。