Elemento personalizzato per NameValueSectionHandler e DictionarySectionHandler

Articolo
04/11/2008

Definisce le impostazioni per le sezioni di configurazione personalizzate in cui viene utilizzata la classe NameValueSectionHandler o DictionarySectionHandler.

<configuration>
** <sectionName>**

<sectionName> </sectionName>

Elementi figlio

Elemento	Descrizione
Elemento <add> per NameValueSectionHandler e DictionarySectionHandler	Aggiunge le impostazioni personalizzate.
Elemento <remove> per NameValueSectionHandler e DictionarySectionHandler	Rimuove un'impostazione definita in precedenza.
Elemento <clear> perNameValueSectionHandler e DictionarySectionHandler	Cancella tutte le impostazioni definite in precedenza in una sezione.

Osservazioni

<sectionName> è un elemento personalizzato definito da un tag <section> nell'elemento <configSections>.

Nella tabella riportata di seguito è indicato il tipo di oggetto restituito dal metodo ConfigurationSettings.GetConfig per ciascun gestore delle sezioni di configurazione.

Gestore della sezione di configurazione	Tipo restituito
DictionarySectionHandler	Systems.Collections.IDictionary
NameValueSectionHandler	Systems.Collections.Specialized.NameValueCollection

Esempio

Nell'esempio riportato di seguito viene illustrato come dichiarare le sezioni in cui vengono utilizzate le classi DictionarySectionHandler e NameValueSectionHandler. Gli elementi personalizzati sono <dictionarySample>, che contiene le impostazioni lette dalla classe DictionarySectionHandler, e <mySection>, che contiene le impostazioni lette dalla classe NameValueSectionHandler.

<configuration>
   <configSections>
      <section name="dictionarySample"
         type="System.Configuration.DictionarySectionHandler,System"/>
      <sectionGroup name="mySectionGroup">
         <section name="mySection"
            type="System.Configuration.NameValueSectionHandler,System" />
      </sectionGroup>
   </configSections>
   <dictionarySample>
      <add key="myKey" value="myValue"/>
   </dictionarySample>
   <mySectionGroup>
      <mySection>
         <add key="key1" value="value1" />
      </mySection>
   </mySectionGroup>
</configuration>

File di configurazione

L'elemento può essere utilizzato nei file di configurazione dell'applicazione e del computer (Machine.config), nonché nei file Web.config che non si trovano al livello di directory dell'applicazione.

Vedere anche

Schema delle sezioni di configurazione | Impostazioni delle sezioni di configurazione

Condividi tramite