Attributi generali ereditati da elementi di sezioni

  • Articolo

[Questa documentazione ha solo scopo di anteprima ed è soggetta a modifiche nelle versioni successive. Gli argomenti vuoti sono inclusi come segnaposto.]

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 ASP.NET Configuration Files o Format of ASP.NET Configuration Files.

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 della raccolta per bloccarli in modo specifico all'interno di una determinata raccolta. 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à

How to: Lock ASP.NET Configuration Settings

Concetti

ASP.NET Configuration Overview

Configuration Inheritance

Securing Configuration

Format of ASP.NET Configuration Files

Altre risorse

ASP.NET Configuration Files