SectionInformation.ForceSave プロパティとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

SectionInformation.ForceSave プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

関連付けられている構成セクションが変更されていない場合も保存されるかどうかを示す値を取得または設定します。

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

Visual Basic (宣言)

Public Property ForceSave As
 Boolean

Visual Basic (使用法)

Dim instance As SectionInformation
Dim value As Boolean

value = instance.ForceSave

instance.ForceSave = value

public bool ForceSave { get;
 set; }

C++

public:
property bool ForceSave {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_ForceSave ()

/** @property */
public void set_ForceSave (boolean value)

JScript

public function get ForceSave
 () : boolean

public function set ForceSave
 (value : boolean)

プロパティ値
関連付けられている ConfigurationSection オブジェクトが変更されていない場合も保存される場合は true。それ以外の場合は false。既定値は false です。

使用例

ConfigurationSection オブジェクトの ForceSave プロパティを使用する方法の例を次に示します。

Visual Basic

' Create a section whose name is 
' MyUrls that contains a nested collection as 
' defined by the UrlsSection class.
Shared Sub CreateSection() 
    Dim sectionName As String
 = "MyUrls"
    
    Try
        
        ' Get the current configuration file.
        Dim config _
        As System.Configuration.Configuration = _
        ConfigurationManager.OpenExeConfiguration( _
        ConfigurationUserLevel.None)
        
        Dim urlsSection As UrlsSection
        
        ' Create the section whose name
        ' attribute isMyUrls in 
        ' <configSections>.
        ' Also, create the related target section 
        ' MyUrls in <configuration>.
        If config.Sections(sectionName) Is
 Nothing Then
            urlsSection = New UrlsSection()
            
            ' Change the default values of 
            ' the simple element.
            urlsSection.Simple.Name = "Contoso"
            urlsSection.Simple.Url = "http://www.contoso.com"
            urlsSection.Simple.Port = 8080
            
            config.Sections.Add(sectionName, urlsSection)
            urlsSection.SectionInformation.ForceSave = True
            config.Save(ConfigurationSaveMode.Full)
        End If
    Catch e As ConfigurationErrorsException
        Console.WriteLine("[CreateSection: {0}]",
 e.ToString())
    End Try

End Sub 'CreateSection

// Create a section whose name is 
// MyUrls that contains a nested collection as 
// defined by the UrlsSection class.
static void CreateSection()
{
    string sectionName = "MyUrls";

    try
    {

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

        UrlsSection urlsSection;

        // Create the section whose name attribute 
        // is MyUrls in <configSections>.
        // Also, create the related target section 
        // MyUrls in <configuration>.
        if (config.Sections[sectionName] == null)
        {
            urlsSection = new UrlsSection();

            // Change the default values of 
            // the simple element.
            urlsSection.Simple.Name = "Contoso";
            urlsSection.Simple.Url =  "http://www.contoso.com";
            urlsSection.Simple.Port = 8080;

            config.Sections.Add(sectionName, urlsSection);
            urlsSection.SectionInformation.ForceSave = true;
            config.Save(ConfigurationSaveMode.Full);
        }
    }
    catch (ConfigurationErrorsException e)
    {
        Console.WriteLine("[CreateSection: {0}]",
            e.ToString());
    }


}