ConfigurationManager.RefreshSection メソッド

.NET Framework クラス ライブラリ リファレンス

ConfigurationManager.RefreshSection メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

名前付きセクションを次回取得するときに、ディスクから再読み取りするように、名前付きセクションを更新します。

名前空間: System.Configuration
アセンブリ: System.Configuration (system.configuration.dll 内)
構文

Visual Basic (宣言)

Public Shared Sub RefreshSection
 ( _
    sectionName As String _
)

Visual Basic (使用法)

Dim sectionName As String

ConfigurationManager.RefreshSection(sectionName)

C#

public static void RefreshSection
 (
    string sectionName
)

C++

public:
static void RefreshSection (
    String^ sectionName
)

J#

public static void RefreshSection
 (
    String sectionName
)

JScript

public static function RefreshSection
 (
    sectionName : String
)

パラメータ

sectionName

更新する構成セクション名、またはセクションの構成パスとセクション名。

解説

このメソッドは、他のセクションに影響を及ぼさずに、指定した構成セクションのキャッシュを無効にします。

使用例

RefreshSection メソッドを使用して、アプリケーション設定の構成セクションを更新する方法を次のコード例に示します。

Visual Basic

' Set appSettings.
Shared Sub SetAppSettings(refresh As
 Boolean)
   ' Get the machine.config file.
     Dim config As System.Configuration.Configuration
 = _
     ConfigurationManager.OpenExeConfiguration( _
     ConfigurationUserLevel.None)
   
   Dim appStgCnt As Integer
 = ConfigurationManager.AppSettings.Count
   Dim asName As String
 = "AppSetting" + appStgCnt.ToString()
   
     config.AppSettings.Settings.Add(asName, _
     DateTime.Now.ToLongDateString() + " " + _
     DateTime.Now.ToLongTimeString())
   
   ' Save the configuration file.
   config.Save(ConfigurationSaveMode.Modified)
   
   ' Refresh the appSettings section so the secction
   ' is read from the disk and not from the cache when
   ' requested, next time.
   If refresh Then
      ConfigurationManager.RefreshSection("AppSettings")
     End If

     GetAppSettings()

End Sub 'SetAppSettings

C#

// Set appSettings.
static void SetAppSettings(bool
 refresh)
{
    // Get the machine.config file.
    System.Configuration.Configuration config =
            ConfigurationManager.OpenExeConfiguration(
            ConfigurationUserLevel.None);

    int appStgCnt = ConfigurationManager.AppSettings.Count;
    string asName = "AppSetting" + appStgCnt.ToString();

    config.AppSettings.Settings.Add(asName,
        DateTime.Now.ToLongDateString() + " " +
        DateTime.Now.ToLongTimeString());

    
    // Save the configuration file.
    config.Save(ConfigurationSaveMode.Modified);

    // Refresh the appSettings section so the secction
    // is read from the disk and not from the cache when
    // requested, next time.
    if (refresh)
        ConfigurationManager.RefreshSection("AppSettings");

    GetAppSettings();
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ConfigurationManager クラス
ConfigurationManager メンバ
System.Configuration 名前空間
GetSection