Export (0) Print
Expand All

SectionInformation.ForceSave Property

Gets or sets a value that indicates whether the associated configuration section will be saved even if it has not been modified.

Namespace:  System.Configuration
Assembly:  System.Configuration (in System.Configuration.dll)

'Declaration
Public Property ForceSave As Boolean

Property Value

Type: System.Boolean
true if the associated ConfigurationSection object will be saved even if it has not been modified; otherwise, false. The default is false.
NoteNote

If the configuration file is saved (even if there are no modifications), ASP.NET restarts the application.

The following example shows how to use the ForceSave property of a ConfigurationSection object.

    ' 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

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft