SectionInformation.ConfigSource Property (System.Configuration)

ConfigSource Property

Switch on low bandwidth view

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

.NET Framework Class Library

SectionInformation..::.ConfigSource Property

Gets or sets the name of the include file in which the associated configuration section is defined, if such a file exists.

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

Syntax

Visual Basic (Declaration)

Public Property ConfigSource As String

Visual Basic (Usage)

Dim instance As SectionInformation
Dim value As String

value = instance.ConfigSource

instance.ConfigSource = value

public string ConfigSource { get; set; }

Visual C++

public:
property String^ ConfigSource {
    String^ get ();
    void set (String^ value);
}

JScript

public function get ConfigSource () : String
public function set ConfigSource (value : String)

Property Value

Type: System..::.String
The name of the include file in which the associated ConfigurationSection is defined, if such a file exists; otherwise, an empty string ("").

Remarks

The ConfigSource property represents the value of the configSource attribute that is specified for a ConfigurationSection object that is associated with the SectionInformation object.

A ConfigurationSection implementation can optionally specify a separate file in which the configuration settings for that section are defined. This can be useful in multiple ways:

Using include files can result in a more logical and modular structure for configuration files.
File-access security and permissions can be used to restrict access to sections of configuration settings.
Settings in an include file that are not used during application initialization can be modified and reloaded without requiring an application restart.

The following example shows how this attribute is used in a configuration file to specify that the pages section is defined in an external include file:

If any of the settings in a configuration include file require the application to restart when they are modified, set the RestartOnExternalChanges property to true.

Platforms

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

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

Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0

Reference

SectionInformation Class

SectionInformation Members

System.Configuration Namespace

RestartOnExternalChanges