SectionInformation.ConfigSource Property

Definition

Ottiene o imposta il nome dell'eventuale file di inclusione in cui è definita la sezione di configurazione associata.Gets or sets the name of the include file in which the associated configuration section is defined, if such a file exists.

public:
 property System::String ^ ConfigSource { System::String ^ get(); void set(System::String ^ value); };
public string ConfigSource { get; set; }
member this.ConfigSource : string with get, set
Public Property ConfigSource As String

Property Value

String

Nome dell'eventuale file di inclusione in cui è definita la classe ConfigurationSection associata; in caso contrario, una stringa vuota ("").The name of the include file in which the associated ConfigurationSection is defined, if such a file exists; otherwise, an empty string ("").

Remarks

La proprietà ConfigSource rappresenta il valore dell'attributo configSource specificato per un ConfigurationSection oggetto associato all'oggetto SectionInformation.The ConfigSource property represents the value of the configSource attribute that is specified for a ConfigurationSection object that is associated with the SectionInformation object.

Un'implementazione di ConfigurationSection può facoltativamente specificare un file separato in cui sono definite le impostazioni di configurazione per la sezione.A ConfigurationSection implementation can optionally specify a separate file in which the configuration settings for that section are defined. Questa operazione può essere utile in diversi modi:This can be useful in multiple ways:

  • L'uso di file di inclusione può produrre una struttura più logica e modulare per i file di configurazione.Using include files can result in a more logical and modular structure for configuration files.

  • È possibile usare la sicurezza e le autorizzazioni di accesso ai file per limitare l'accesso alle sezioni delle impostazioni di configurazione.File-access security and permissions can be used to restrict access to sections of configuration settings.

  • Le impostazioni in un file di inclusione che non vengono usate durante l'inizializzazione dell'applicazione possono essere modificate e ricaricate senza richiedere il riavvio dell'applicazione.Settings in an include file that are not used during application initialization can be modified and reloaded without requiring an application restart.

Nell'esempio seguente viene illustrato il modo in cui questo attributo viene utilizzato in un file di configurazione per specificare che la sezione pages è definita in un file di inclusione esterno: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:

<pages configSource="pages.config"/>

Se una delle impostazioni in un file di inclusione della configurazione richiede che l'applicazione venga riavviata quando vengono modificate, impostare la proprietà RestartOnExternalChanges su true.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.

Nelle applicazioni ASP.NET, in fase di esecuzione è possibile assegnare alla proprietà ConfigSource il nome di un file di configurazione alternativo.In ASP.NET applications, at run time you can assign to the ConfigSource property the name of an alternative configuration file. In tal caso, il contenuto del file viene sovrascritto dalle informazioni predefinite della stringa di connessione contenute nel file Web. config.In that case, the contents of the file are overwritten by the default connection string information that is contained in the Web.config file. Questa situazione si verifica anche quando il file alternativo non esiste e viene creato in fase di esecuzione.This occurs also when the alternative file does not exist and it is created at run time. Se il file Web. config non contiene informazioni sulla stringa di connessione, viene aggiunta una sezione vuota al file alternativo.If the Web.config file does not contain any connection string information, an empty section is added to the alternative file.

Applies to

See also