WebConfigurationManager Classe

Definizione

Spazio dei nomi:

System.Web.Configuration

Assembly:

System.Web.dll

Fornisce accesso ai file di configurazione quando si applicano alle applicazioni Web.

public ref class WebConfigurationManager abstract sealed

public static class WebConfigurationManager

type WebConfigurationManager = class

Public Class WebConfigurationManager

Ereditarietà

Object

WebConfigurationManager

Esempio

Nell'esempio seguente viene illustrato come accedere alle informazioni di configurazione con

MetodoGetSection .

// Show how to use the GetSection(string). 
// to access the connectionStrings section.
static void GetConnectionStringsSection()
{

    // 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();
}

' Show how to use the GetSection(string). 
' to access the connectionStrings section.
Shared Sub GetConnectionStringsSection()
   
   ' 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

Commenti

La WebConfigurationManager classe consente di accedere alle informazioni sul computer e sull'applicazione.

L'uso WebConfigurationManager è il modo preferito per usare i file di configurazione correlati alle applicazioni Web. Per le applicazioni client, usare la ConfigurationManager classe .

L'applicazione può estendere i tipi o usarli direttamente per gestire le System.Configuration informazioni di configurazione, come illustrato nell'elenco seguente:

• Handling configuration. Per gestire le informazioni di configurazione usando i tipi standard, usare uno degli approcci seguenti:

  • Accessing a section. Per accedere alle informazioni di configurazione per l'applicazione, è necessario usare uno dei GetSection metodi forniti da WebConfigurationManager. Per <appSettings> e <connectionStrings>, si usano le AppSettings proprietà e ConnectionStrings . Questi metodi eseguono operazioni di sola lettura, usano un'unica istanza memorizzata nella cache della configurazione e sono con riconoscimento multithread.

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

  • Advanced configuration. La gestione della configurazione più avanzata viene fornita dai tipi SectionInformation, PropertyInformationCollectionContextInformationConfigurationSectionGroupPropertyInformationElementInformatione .ConfigurationSectionGroupCollection

• Extending configuration standard types. È anche possibile fornire gli elementi di configurazione personalizzati estendendo i tipi di configurazione standard, ConfigurationElementad esempio , ConfigurationElementCollection, ConfigurationPropertye ConfigurationSection usando un modello a livello di codice o con attributi. Fare riferimento alla ConfigurationSection classe per un esempio di come estendere un tipo di configurazione standard a livello di codice. Fare riferimento alla ConfigurationElement classe per un esempio di come estendere un tipo di configurazione standard usando il modello con attributi.

Note per gli eredi

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

Si usano GetSection(String) o GetSectionGroup(String) per leggere le informazioni di configurazione. Si noti che l'utente o il processo che legge devono avere le autorizzazioni seguenti:

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

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

Se l'applicazione richiede l'accesso in sola lettura alla propria configurazione, è consigliabile usare i GetSection metodi. Questi metodi forniscono l'accesso ai valori di configurazione memorizzati nella cache per l'applicazione corrente, con prestazioni migliori rispetto alla Configuration classe.

Nota: se si usa un metodo statico GetSection che accetta un path parametro, il parametro path deve fare riferimento all'applicazione in cui è in esecuzione il codice. In caso contrario, il parametro viene ignorato e le informazioni di configurazione per l'applicazione attualmente in esecuzione vengono restituite.

Si usa uno dei metodi per scrivere informazioni di Save configurazione. Si noti che l'utente o il processo che scrive deve disporre delle autorizzazioni seguenti:

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

• Autorizzazioni di lettura per tutti i file di configurazione.

Proprietà

AppSettings	Ottiene le impostazioni dell'applicazione del sito Web.
ConnectionStrings	Ottiene le stringhe di connessione del sito Web.

Metodi

GetSection(String)	Recupera la sezione di configurazione specificata dal file di configurazione dell'applicazione Web corrente.
GetSection(String, String)	Recupera la sezione di configurazione specificata dal file di configurazione dell'applicazione Web nella posizione specificata.
GetWebApplicationSection(String)	Recupera la sezione di configurazione specificata dal file di configurazione dell'applicazione Web corrente.
OpenMachineConfiguration()	Apre il file di configurazione del computer sul computer corrente come oggetto Configuration per consentire le operazioni di lettura e scrittura.
OpenMachineConfiguration(String)	Apre il file di configurazione del computer sul computer corrente come oggetto Configuration per consentire le operazioni di lettura e scrittura.
OpenMachineConfiguration(String, String)	Apre il file di configurazione del computer specificato sul server specificato come oggetto Configuration per consentire le operazioni di lettura e scrittura.
OpenMachineConfiguration(String, String, IntPtr)	Apre il file di configurazione del computer specificato sul server specificato come oggetto Configuration, utilizzando il contesto di sicurezza per consentire le operazioni di lettura e scrittura.
OpenMachineConfiguration(String, String, String, String)	Apre il file di configurazione del computer specificato sul server specificato come oggetto Configuration, utilizzando il contesto di sicurezza per consentire le operazioni di lettura e scrittura.
OpenMappedMachineConfiguration(ConfigurationFileMap)	Apre il file di configurazione del computer come oggetto Configuration, utilizzando il mapping del file specificato per consentire le operazioni di lettura e scrittura.
OpenMappedMachineConfiguration(ConfigurationFileMap, String)	Apre il file di configurazione del computer come oggetto Configuration, utilizzando il mapping e il percorso del file specificato per consentire le operazioni di lettura e scrittura.
OpenMappedWebConfiguration(WebConfigurationFileMap, String)	Apre il file di configurazione dell'applicazione Web specificato come oggetto Configuration, utilizzando il mapping del file specificato e il percorso virtuale per consentire le operazioni di lettura e scrittura.
OpenMappedWebConfiguration(WebConfigurationFileMap, String, String)	Apre il file di configurazione dell'applicazione Web specificato come oggetto Configuration, utilizzando il mapping del file specificato, il percorso virtuale e il nome del sito per consentire le operazioni di lettura e scrittura.
OpenMappedWebConfiguration(WebConfigurationFileMap, String, String, String)	Apre il file di configurazione dell'applicazione Web specificato come oggetto Configuration, utilizzando il mapping del file specificato, il percorso virtuale, il nome del sito e il percorso per consentire le operazioni di lettura e scrittura.
OpenWebConfiguration(String)	Apre il file di configurazione dell'applicazione Web come oggetto Configuration, utilizzando il percorso virtuale specificato per consentire le operazioni di lettura e scrittura.
OpenWebConfiguration(String, String)	Apre il file di configurazione dell'applicazione Web come oggetto Configuration, utilizzando il percorso virtuale specificato e il nome del sito per consentire le operazioni di lettura e scrittura.
OpenWebConfiguration(String, String, String)	Apre il file di configurazione dell'applicazione Web come oggetto Configuration, utilizzando il percorso virtuale specificato, il nome del sito e il percorso per consentire le operazioni di lettura e scrittura.
OpenWebConfiguration(String, String, String, String)	Apre il file di configurazione dell'applicazione Web come oggetto Configuration, utilizzando il percorso virtuale specificato, il nome del sito, il percorso e il server per consentire le operazioni di lettura e scrittura.
OpenWebConfiguration(String, String, String, String, IntPtr)	Apre il file di configurazione dell'applicazione Web come oggetto Configuration, utilizzando il percorso virtuale specificato, il nome del sito, il percorso, il server e il contesto di sicurezza per consentire le operazioni di lettura e scrittura.
OpenWebConfiguration(String, String, String, String, String, String)	Apre il file di configurazione dell'applicazione Web come oggetto Configuration, utilizzando il percorso virtuale specificato, il nome del sito, il percorso, il server e il contesto di sicurezza per consentire le operazioni di lettura e scrittura.

Vedi anche

• Configuration
• ConfigurationManager
• Panoramica della configurazione di ASP.NET