WebConfigurationManager Classe

Definizione

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

GetSection Il metodo.

// 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 di è il modo migliore 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 , si usano le <connectionStrings> proprietà e AppSettingsConnectionStrings . Questi metodi eseguono operazioni di sola lettura, usano una singola istanza memorizzata nella cache della configurazione e sono in grado di supportare il multithread.

  • Accessing configuration files. L'applicazione può leggere e scrivere impostazioni di configurazione a qualsiasi livello, per se stesso o per altre applicazioni o computer, in locale o in remoto. Si usa uno dei metodi di open forniti da WebConfigurationManager. Questi metodi restituiscono 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, , PropertyInformationPropertyInformationCollectionElementInformationContextInformationConfigurationSectionGroupe .ConfigurationSectionGroupCollection

• Extending configuration standard types. È anche possibile fornire gli elementi di configurazione personalizzati estendendo i tipi di configurazione standard, ad ConfigurationElementesempio , ConfigurationElementCollection, ConfigurationPropertye ConfigurationSection usando un modello a livello di codice o con attributi. Per un esempio di come estendere un tipo di configurazione standard a livello di codice, vedere la ConfigurationSection classe . 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 Configuration classe consente l'accesso a livello di codice per la modifica dei file di configurazione. Si usa uno dei metodi aperti forniti da WebConfigurationManager. Questi metodi restituiscono 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:

GetSection(String) Usare o GetSectionGroup(String) per leggere le informazioni di configurazione. Si noti che l'utente o il processo che le letture deve 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 vengono restituite le informazioni di configurazione per l'applicazione attualmente in esecuzione.

Si usa uno dei Save metodi per scrivere informazioni di 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.

Vedi anche

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