SectionInformation.ConfigSource Proprietà

Definizione

Spazio dei nomi:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacchetto:

System.Configuration.ConfigurationManager v8.0.0

Source:

SectionInformation.cs

Ottiene o imposta il nome dell'eventuale file di inclusione in cui è definita la sezione di configurazione associata.

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

Valore della proprietà

String

Nome dell'eventuale file di inclusione in cui è definita la classe ConfigurationSection associata; in caso contrario, una stringa vuota ("").

Commenti

La ConfigSource proprietà rappresenta il valore dell'attributo configSource specificato per un ConfigurationSection oggetto associato all'oggetto SectionInformation .

Un'implementazione ConfigurationSection può facoltativamente specificare un file separato in cui vengono definite le impostazioni di configurazione per tale sezione. Ciò può essere utile in diversi modi:

• L'uso di file di inclusione può comportare una struttura più logica e modulare per i file di configurazione.

• La sicurezza e le autorizzazioni di accesso ai file possono essere usate per limitare l'accesso alle sezioni delle impostazioni di configurazione.

• Le impostazioni in un file di inclusione che non vengono usate durante l'inizializzazione dell'applicazione possono essere modificate e ricaricate senza richiedere un riavvio dell'applicazione.

L'esempio seguente mostra come questo attributo viene usato in un file di configurazione per specificare che la pages sezione è definita in un file di inclusione esterno:

<pages configSource="pages.config"/>

Se una delle impostazioni in un file di inclusione di configurazione richiede il riavvio dell'applicazione quando vengono modificate, impostare la RestartOnExternalChanges proprietà su true.

In ASP.NET applicazioni è possibile assegnare alla proprietà il ConfigSource nome di un file di configurazione alternativo in fase di esecuzione. In tal caso, il contenuto del file viene sovrascritto dalle informazioni predefinite stringa di connessione contenute nel file Web.config. Ciò si verifica anche quando il file alternativo non esiste e viene creato in fase di esecuzione. Se il file Web.config non contiene informazioni stringa di connessione, al file alternativo viene aggiunta una sezione vuota.

Vedi anche

• RestartOnExternalChanges