SectionInformation.ConfigSource Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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à
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.