La classe WebConfigurationManager consente di accedere alle informazioni relative a computer e applicazioni.

L'utilizzo della classe WebConfigurationManager è il modo migliore per utilizzare i file di configurazione correlati alle applicazioni Web. Per le applicazioni client utilizzare la classe ConfigurationManager.

L'applicazione può estendere i tipi System.Configuration o utilizzarli direttamente per gestire le informazioni sulla configurazione, come spiegato nell'elenco riportato di seguito.

• Handling configuration. Per gestire le informazioni relative alla configurazione mediante i tipi standard, utilizzare uno degli approcci indicati di seguito.

  • Accessing a section. Per accedere alle informazioni sulla configurazione dell'applicazione, è necessario utilizzare uno dei metodi GetSection forniti da WebConfigurationManager. Per <appSettings> e <connectionStrings> utilizzare le proprietà AppSettings e ConnectionStrings. Questi metodi eseguono operazioni in sola lettura, utilizzano una singola istanza memorizzata nella cache e riconoscono il multithreading.

  • Accessing configuration files. L'applicazione consente di leggere e scrivere le impostazioni di configurazione a qualsiasi livello, per se stessa o per altre applicazioni o computer, in modalità locale o remota. Utilizzare uno dei metodi open forniti da WebConfigurationManager. Questi metodi restituiranno un oggetto Configuration, che a sua volta fornisce le proprietà e i metodi richiesti per gestire i file di configurazione sottostanti. Tali metodi eseguono operazioni in lettura o in scrittura e ricreano i dati di configurazione ogni volta che viene aperto un file.

  • Advanced configuration. La gestione della configurazione più avanzata è fornita dai tipi SectionInformation, PropertyInformation, PropertyInformationCollection, ElementInformation, ContextInformation, ConfigurationSectionGroup e ConfigurationSectionGroupCollection.

• Extending configuration standard types. È possibile fornire inoltre elementi di configurazione personalizzati estendendo i tipi di configurazione standard, ad esempio ConfigurationElement, ConfigurationElementCollection, ConfigurationProperty e ConfigurationSection, utilizzando un modello a livello di codice o con attributi. Per un esempio sull'estensione di un tipo standard di configurazione a livello di codice, fare riferimento alla classe ConfigurationSection. Per un esempio sull'estensione di un tipo standard di configurazione utilizzando il modello con attributi, fare riferimento alla classe ConfigurationElement.

Note per gli implementatori:

La classe Configuration consente l'accesso a livello di codice per la modifica dei file di configurazione. A tale proposito, utilizzare uno dei metodi aperti forniti da WebConfigurationManager. Questi metodi restituiranno un oggetto Configuration, che a sua volta fornisce i metodi e le proprietà richiesti per gestire i file di configurazione sottostanti. È possibile accedere a questi file per la lettura e la scrittura come riportato di seguito.

Utilizzare il metodo GetSection o GetSectionGroup per leggere le informazioni di configurazione. Si noti che l'utente o il processo che legge deve disporre delle seguenti autorizzazioni:

• Autorizzazione di lettura per il file di configurazione al livello di gerarchia della configurazione corrente.

• Autorizzazioni di lettura per tutti i file di configurazione padre.

Se l'applicazione necessita di accesso in sola lettura alla propria configurazione, si consiglia di utilizzare i metodi GetSection. Questi metodi forniscono accesso ai valori di configurazione memorizzati nella cache per l'applicazione corrente, le cui prestazioni sono migliori di quelle della classe Configuration.

Nota:
Se si utilizza un metodo GetSection statico che accetta un parametro path, il parametro deve fare riferimento all'applicazione in cui è in esecuzione il codice; in caso contrario, il parametro verrà ignorato e verranno restituite le informazioni di configurazione per l'applicazione attualmente in esecuzione.

Utilizzare uno dei metodi Save per la scrittura delle informazioni di configurazione. Si noti che l'utente o il processo che esegue la scrittura deve disporre delle seguenti autorizzazioni:

• Autorizzazione di scrittura per il file e la directory di configurazione al livello di gerarchia della configurazione corrente.

• Autorizzazioni di lettura per tutti i file di configurazione.

Nell'esempio riportato di seguito viene illustrato come accedere alle informazioni sulla configurazione con il metodo WebConfigurationManager.

' Show the use of GetSection(string). 
' It gets the connectiobStrings section.
' If called from within a client application,
' the GetSection(string) gets the default connectionStrings
' section from the machine.config.
' If called from within a Web aplication it gets the
' section from the configuration file located at the 
' application current level. 
Shared Sub GetSection1()

   ' Get the connectionStrings section.
     Dim connectionStringsSection As ConnectionStringsSection = _
     WebConfigurationManager.GetSection("connectionStrings")

   ' Get the connectionStrings key,value pairs collection.
     Dim connectionStrings As ConnectionStringSettingsCollection = _
     connectionStringsSection.ConnectionStrings

   ' Get the collection enumerator.
     Dim connectionStringsEnum As IEnumerator = _
     connectionStrings.GetEnumerator()

   ' Loop through the collection and 
   ' display the connectionStrings key, value pairs.
   Dim i As Integer = 0
   Console.WriteLine("[Display the connectionStrings]")
   While connectionStringsEnum.MoveNext()
      Dim name As String = connectionStrings(i).Name
         Console.WriteLine("Name: {0} Value: {1}", _
         name, connectionStrings(name))
      i += 1
   End While

   Console.WriteLine()
End Sub 'GetSection1

// Show the use of GetSection(string). 
// It gets the connectiobStrings section.
// If called from within a client application,
// the GetSection(string) gets the default connectionStrings
// section from the machine.config.
// If called from within a Web aplication it gets the
// section from the configuration file located at the 
// application current level. 
static void GetSection1()
{

    // Get the connectionStrings section.
    ConnectionStringsSection connectionStringsSection =
        WebConfigurationManager.GetSection("connectionStrings")
        as ConnectionStringsSection;

    // Get the connectionStrings key,value pairs collection.
    ConnectionStringSettingsCollection connectionStrings =
        connectionStringsSection.ConnectionStrings;

    // Get the collection enumerator.
    IEnumerator connectionStringsEnum =
        connectionStrings.GetEnumerator();

    // Loop through the collection and 
    // display the connectionStrings key, value pairs.
    int i = 0;
    Console.WriteLine("[Display the connectionStrings]");
    while (connectionStringsEnum.MoveNext())
    {
        string name = connectionStrings[i].Name;
        Console.WriteLine("Name: {0} Value: {1}",
        name, connectionStrings[name]);
        i += 1;
    }

    Console.WriteLine();
}

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition , Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

.NET Framework

Riferimenti

Altre risorse