Attributi generali ereditati da elementi di sezioni
Aggiornamento: novembre 2007
In ASP.NET, le impostazioni di configurazione vengono applicate alle risorse in modo gerarchico. Le impostazioni di configurazione vengono ereditate dai file di configurazione padre. In questo argomento sono elencati diversi attributi generali ereditati da tutti gli elementi della sezione.
Elementi Section
Gli elementi Section sono membri delle sezioni di configurazione. Sono esclusi gli elementi membri di gruppi di sezioni di configurazione.
Le dichiarazioni della sezione di configurazione vengono visualizzate all'inizio del file di configurazione nell'elemento configSections. Ogni dichiarazione contenuta in un elemento section specifica il nome di una sezione e il nome della classe .NET Framework, derivata da ConfigurationSection, che elabora i dati di configurazione in tale sezione. È possibile raggruppare i tag section in tag sectionGroup.
Per ulteriori informazioni, vedere File di configurazione ASP.NET o Modifica dei file di configurazione ASP.NET.
Attributi generali
Nella tabella seguente vengono descritti gli attributi generali che è possibile impostare per qualsiasi elemento section. Tali attributi vengono inoltre ereditati dagli elementi figlio degli elementi della sezione. Tutti gli attributi i cui nomi includono il lavoro lock sono stati progettati per proteggere da eventuali modifiche il contenuto specificato nel file di configurazione. Nessun elemento o attributo è bloccato per impostazione predefinita.
Attributo |
Descrizione |
---|---|
configSource |
Attributo String facoltativo. Specifica il nome del file di inclusione in cui viene definita la sezione di configurazione associata, se tale file esiste. È possibile accedervi a livello di codice attraverso la proprietà ConfigSource. Quando si utilizza l'attributo configSource, è necessario spostare tutta la sezione in un file separato in quanto non si verifica l'unione delle impostazioni degli elementi. Qualsiasi modifica apportata al file esterno determina il riavvio dell'applicazione per impostazione predefinita. Per modificare questo comportamento ed evitare che l'applicazione venga riavviata a seguito di ogni modifica, è possibile configurare Elemento section per configSections (schema delle impostazioni generali) nel file Web.config e impostare il rispettivo attributo restartOnExternalChanges su false. |
lockAllAttributesExcept |
Attributo String facoltativo. Il valore può essere un elenco separato da virgole. Blocca tutti gli attributi dell'elemento padre, ad eccezione di quelli specificati. È possibile accedervi a livello di codice attraverso la proprietà LockAllAttributesExcept. I livelli inferiori della gerarchia di configurazione non possono mai bloccare i livelli superiori. |
lockAllElementsExcept |
Attributo String facoltativo. Il valore può essere un elenco separato da virgole. Blocca tutti gli elementi figlio dell'elemento padre, ad eccezione di quelli specificati. È possibile accedervi a livello di codice attraverso la proprietà LockAllElementsExcept. |
lockAttributes |
Attributo String facoltativo. Il valore può essere un elenco separato da virgole. Blocca tutti gli attributi dell'elemento padre. È possibile accedervi a livello di codice attraverso la proprietà LockAttributes. |
lockElements |
Attributo String facoltativo. Il valore può essere un elenco separato da virgole. Blocca tutti gli elementi figlio dell'elemento padre. È possibile accedervi a livello di codice attraverso la proprietà LockElements. |
lockItem |
Attributo String facoltativo. true se l'elemento su cui si verifica l'attributo deve essere bloccato. In caso contrario, false. Il valore predefinito è false. Oltre che per bloccare eventuali elementi singoli, questo attributo può essere utilizzato anche sugli elementi dell'insieme per bloccarli in modo specifico all'interno di un determinato insieme. L'attributo consente anche di bloccare un'intera sezione. È possibile accedervi a livello di codice attraverso la proprietà LockItem. |
Esempio
L'esempio di codice che segue è una parte del file Machine.config. I gestori delle sezioni di configurazione vengono dichiarati per il gruppo di sezioni system.web e per la sezione anonymousIdentification. Di seguito vengono dichiarati gli elementi di configurazione system.Web e anonymousIdentification.
L'elemento di configurazione system.Web è membro di un gruppo di sezioni di configurazione e pertanto non contiene alcun attributo.
Poiché l'elemento di configurazione anonymousIdentification è membro di una sezione di configurazione, eredita gli attributi elencati nella tabella precedente. Si osservi che al rispettivo attributo configSource è assegnato un file esterno (in cui è incluso il contenuto dell'elemento) e che l'attributo lockItem è impostato su true per evitare che il relativo contenuto venga modificato.
<configuration>
<configSections>
<!-- Other configuration sections. -->
<sectionGroup name="system.web" ...>
<section name="anonymousIdentification" ... />
</sectionGroup>
</configSections>
<system.web>
<anonymousIdentification configSource="IDSourceFile.xml"
lockItem="true" />
</system.web>
</configuration>
Vedere anche
Attività
Procedura: bloccare le impostazioni di configurazione di ASP.NET
Concetti
Cenni preliminari sulla configurazione di ASP.NET
Scenari di configurazione ASP.NET
Protezione della configurazione di ASP.NET
Modifica dei file di configurazione ASP.NET