SectionInformation.RestartOnExternalChanges Property

Definition

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets or sets a value that specifies whether a change in an external configuration include file requires an application restart.

C#
public bool RestartOnExternalChanges { get; set; }

Property Value

true if a change in an external configuration include file requires an application restart; otherwise, false. The default is true.

Exceptions

The selected value conflicts with a value that is already defined.

Examples

The following example shows how to get the RestartOnExternalChanges property value of a ConfigurationSection object.

C#
static public void RestartOnExternalChanges()
{
    SectionInformation sInfo =
        GetSectionInformation();

    bool restartOnChange = 
        sInfo.RestartOnExternalChanges;
    Console.WriteLine("Section type: {0}", 
        restartOnChange.ToString());
}

Remarks

Set the RestartOnExternalChanges property to false to prevent an application restart when configuration settings in the external include file are modified for this ConfigurationSection object.

Applies to

Product Versions
.NET 8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0 (package-provided)
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10