This documentation is archived and is not being maintained.

SectionInformation.RestartOnExternalChanges Property

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

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

public bool RestartOnExternalChanges { get; set; }
/** @property */
public boolean get_RestartOnExternalChanges ()

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

public function get RestartOnExternalChanges () : boolean

public function set RestartOnExternalChanges (value : boolean)

Not applicable.

Property Value

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

Exception typeCondition

ConfigurationErrorsException

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

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.

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

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

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

}

Windows 98, Windows Server 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

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0
Show: