WebConfigurationManager Class

Definition

Fornisce accesso ai file di configurazione quando si applicano alle applicazioni Web.Provides access to configuration files as they apply to Web applications.

public ref class WebConfigurationManager abstract sealed
public static class WebConfigurationManager
type WebConfigurationManager = class
Public Class WebConfigurationManager
Inheritance
WebConfigurationManager

Examples

Nell'esempio seguente viene illustrato come accedere alle informazioni di configurazione conThe following example shows how to access configuration information with the

MetodoGetSection .GetSection method.


// 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


Remarks

La classe WebConfigurationManager consente di accedere alle informazioni sul computer e sull'applicazione.The WebConfigurationManager class allows you to access computer and application information.

L'uso di WebConfigurationManager è il modo migliore per lavorare con i file di configurazione correlati alle applicazioni Web.Using WebConfigurationManager is the preferred way to work with configuration files related to Web applications. Per le applicazioni client, usare la classe ConfigurationManager.For client applications, use the ConfigurationManager class.

L'applicazione può estendere i tipi di System.Configuration o utilizzarli direttamente per gestire le informazioni di configurazione, come illustrato nell'elenco seguente:Your application can extend the System.Configuration types or use them directly to handle configuration information, as explained in the following list:

  • Handling configurationHandling configuration. Per gestire le informazioni di configurazione utilizzando i tipi standard, è possibile utilizzare uno degli approcci seguenti:To handle configuration information using the standard types, you use one of the following approaches:

  • Extending configuration standard typesExtending configuration standard types. È anche possibile fornire gli elementi di configurazione personalizzati estendendo i tipi di configurazione standard, ad esempio ConfigurationElement, ConfigurationElementCollection, ConfigurationPropertye ConfigurationSection usando un modello a livello di codice o con attributi.You can also provide your custom configuration elements by extending the standard configuration types such as ConfigurationElement, ConfigurationElementCollection, ConfigurationProperty, and ConfigurationSection by using a programmatic or an attributed model. Per un esempio di estensione di un tipo di configurazione standard a livello di codice, fare riferimento alla classe ConfigurationSection.Refer to the ConfigurationSection class for an example of how to extend a standard configuration type programmatically. Per un esempio su come estendere un tipo di configurazione standard usando il modello con attributi, fare riferimento alla classe ConfigurationElement.Refer to the ConfigurationElement class for an example of how to extend a standard configuration type using the attributed model.

Notes to Inheritors

La classe Configuration consente l'accesso a livello di codice per la modifica dei file di configurazione.The Configuration class allows programmatic access for editing configuration files. Usare uno dei metodi aperti forniti da WebConfigurationManager.You use one of the open methods provided by 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.These methods will return a Configuration object, which in turn provides the required methods and properties to handle the underlying configuration files. È possibile accedere a questi file per la lettura o la scrittura come indicato di seguito:You can access these files for reading or writing as follows: Per leggere le informazioni di configurazione, usare GetSection(String) o GetSectionGroup(String).You use GetSection(String) or GetSectionGroup(String) to read configuration information. Si noti che l'utente o il processo che legge deve avere le autorizzazioni seguenti:Note that the user or process that reads must have the following permissions: -Autorizzazione di lettura per il file di configurazione al livello della gerarchia di configurazione corrente.- Read permission on the configuration file at the current configuration hierarchy level.

-Autorizzazioni di lettura per tutti i file di configurazione padre.- Read permissions on all the parent configuration files.

Se l'applicazione richiede l'accesso in sola lettura alla propria configurazione, è consigliabile usare i metodi GetSection.If your application needs read-only access to its own configuration, it is recommended you use the GetSection methods. Questi metodi consentono di accedere ai valori di configurazione memorizzati nella cache per l'applicazione corrente, che offre prestazioni migliori rispetto alla classe Configuration.These methods provide access to the cached configuration values for the current application, which has better performance than the Configuration class.


Se si usa un metodo di GetSection statico che accetta un parametro di path, 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.If you use a static GetSection method that takes a path parameter, the path parameter must refer to the application in which the code is running; otherwise, the parameter is ignored and configuration information for the currently-running application is returned.

Usare uno dei metodi Save per scrivere le informazioni di configurazione.You use one of the Save methods to write configuration information. Si noti che l'utente o il processo che scrive deve avere le autorizzazioni seguenti:Note that the user or process that writes must have the following permissions: -Autorizzazione di scrittura per il file di configurazione e la directory al livello della gerarchia di configurazione corrente.- Write permission on the configuration file and directory at the current configuration hierarchy level. -Autorizzazioni di lettura per tutti i file di configurazione.- Read permissions on all the configuration files.

Properties

AppSettings

Ottiene le impostazioni dell'applicazione del sito Web.Gets the Web site's application settings.

ConnectionStrings

Ottiene le stringhe di connessione del sito Web.Gets the Web site's connection strings.

Methods

GetSection(String)

Recupera la sezione di configurazione specificata dal file di configurazione dell'applicazione Web corrente.Retrieves the specified configuration section from the current Web application's configuration file.

GetSection(String, String)

Recupera la sezione di configurazione specificata dal file di configurazione dell'applicazione Web nella posizione specificata.Retrieves the specified configuration section from the Web application's configuration file at the specified location.

GetWebApplicationSection(String)

Recupera la sezione di configurazione specificata dal file di configurazione dell'applicazione Web corrente.Retrieves the specified configuration section from the current Web application's configuration file.

OpenMachineConfiguration()

Apre il file di configurazione del computer sul computer corrente come oggetto Configuration per consentire le operazioni di lettura e scrittura.Opens the machine-configuration file on the current computer as a Configuration object to allow read or write operations.

OpenMachineConfiguration(String)

Apre il file di configurazione del computer sul computer corrente come oggetto Configuration per consentire le operazioni di lettura e scrittura.Opens the machine-configuration file on the current computer as a Configuration object to allow read or write operations.

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.Opens the specified machine-configuration file on the specified server as a Configuration object to allow read or write operations.

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.Opens the specified machine-configuration file on the specified server as a Configuration object, using the specified security context to allow read or write operations.

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.Opens the specified machine-configuration file on the specified server as a Configuration object, using the specified security context to allow read or write operations.

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.Opens the machine-configuration file as a Configuration object, using the specified file mapping to allow read or write operations.

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.Opens the machine-configuration file as a Configuration object using the specified file mapping and location to allow read or write operations.

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.Opens the specified Web-application configuration file as a Configuration object using the specified file mapping and virtual path to allow read or write operations.

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.Opens the specified Web application configuration file as a Configuration object using the specified file mapping, virtual path, and site name to allow read or write operations.

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.Opens the specified Web-application configuration file as a Configuration object using the specified file mapping, virtual path, site name, and location to allow read or write operations.

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.Opens the Web-application configuration file as a Configuration object using the specified virtual path to allow read or write operations.

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.Opens the Web-application configuration file as a Configuration object using the specified virtual path and site name to allow read or write operations.

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.Opens the Web-application configuration file as a Configuration object using the specified virtual path, site name, and location to allow read or write operations.

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.Opens the Web-application configuration file as a Configuration object using the specified virtual path, site name, location, and server to allow read or write operations.

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.Opens the Web-application configuration file as a Configuration object using the specified virtual path, site name, location, server, and security context to allow read or write operations.

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.Opens the Web-application configuration file as a Configuration object using the specified virtual path, site name, location, server, and security context to allow read or write operations.

Applies to

See also