WebConfigurationManager WebConfigurationManager WebConfigurationManager WebConfigurationManager Class

Definizione

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
Ereditarietà
WebConfigurationManagerWebConfigurationManagerWebConfigurationManagerWebConfigurationManager

Esempi

Nell'esempio seguente viene illustrato come accedere alle informazioni di configurazione con ilThe 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 'GetSection1


Commenti

Il WebConfigurationManager classe consente di accedere a informazioni computer e dell'applicazione.The WebConfigurationManager class allows you to access computer and application information.

Usando WebConfigurationManager è il modo migliore per lavorare con 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 il ConfigurationManager classe.For client applications, use the ConfigurationManager class.

L'applicazione è possibile estendere il System.Configuration tipi oppure usarli direttamente per gestire le informazioni di configurazione, come illustrato nel seguente elenco:Your application can extend the System.Configuration types or use them directly to handle configuration information, as explained in the following list:

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

  • Extending configuration standard types.Extending configuration standard types. È anche possibile fornire gli elementi di configurazione personalizzato estendendo i tipi di configurazione standard, ad esempio ConfigurationElement, ConfigurationElementCollection, ConfigurationProperty, e ConfigurationSection tramite un livello di codice o un modello con attributo.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. Fare riferimento al ConfigurationSection classe per un esempio di come estendere un tipo di configurazione standard a livello di codice.Refer to the ConfigurationSection class for an example of how to extend a standard configuration type programmatically. Fare riferimento al ConfigurationElement classe per un esempio di come estendere un tipo di configurazione standard usando il modello con attributo.Refer to the ConfigurationElement class for an example of how to extend a standard configuration type using the attributed model.

Note per gli eredi

Il Configuration classe 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 di apertura forniti da WebConfigurationManager.You use one of the open methods provided by WebConfigurationManager. Questi metodi restituiscono un Configuration oggetto, che a sua volta fornisce i metodi richiesti e le proprietà per gestire i file di configurazione sottostante.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 scrittura come indicato di seguito:You can access these files for reading or writing as follows: Si utilizza GetSection(String) o GetSectionGroup(String) per leggere le informazioni di configurazione.You use GetSection(String) or GetSectionGroup(String) to read configuration information. Si noti che l'utente o 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 a livello di gerarchia di configurazione corrente.- Read permission on the configuration file at the current configuration hierarchy level.

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

Se l'applicazione deve accedere in sola lettura per la propria configurazione, è consigliabile usare il GetSection metodi.If your application needs read-only access to its own configuration, it is recommended you use the GetSection methods. Questi metodi forniscono accesso ai valori di configurazione memorizzati nella cache per l'applicazione corrente, che offre prestazioni migliori del Configuration classe.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 valore statico GetSection metodo che accetta un path parametro, il parametro path deve fare riferimento all'applicazione in cui viene eseguito il codice; in caso contrario, il parametro viene ignorato e informazioni di configurazione per l'esecuzione viene restituita l'applicazione.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.

Si utilizza uno del Save i metodi per scrivere le informazioni di configurazione.You use one of the Save methods to write configuration information. Si noti che l'utente o processo che consente di scrivere 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 a livello di 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.

Proprietà

AppSettings AppSettings AppSettings AppSettings

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

ConnectionStrings ConnectionStrings ConnectionStrings ConnectionStrings

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

Metodi

GetSection(String) GetSection(String) GetSection(String) 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) GetSection(String, String) GetSection(String, String) 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) GetWebApplicationSection(String) GetWebApplicationSection(String) 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() OpenMachineConfiguration() OpenMachineConfiguration() 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) OpenMachineConfiguration(String) OpenMachineConfiguration(String) 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) OpenMachineConfiguration(String, String) OpenMachineConfiguration(String, String) 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) OpenMachineConfiguration(String, String, IntPtr) OpenMachineConfiguration(String, String, IntPtr) 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) OpenMachineConfiguration(String, String, String, String) OpenMachineConfiguration(String, String, String, String) 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, String) OpenMappedMachineConfiguration(ConfigurationFileMap, String) OpenMappedMachineConfiguration(ConfigurationFileMap, String) 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.

OpenMappedMachineConfiguration(ConfigurationFileMap) OpenMappedMachineConfiguration(ConfigurationFileMap) OpenMappedMachineConfiguration(ConfigurationFileMap) 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.

OpenMappedWebConfiguration(WebConfigurationFileMap, String) OpenMappedWebConfiguration(WebConfigurationFileMap, String) OpenMappedWebConfiguration(WebConfigurationFileMap, String) 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) OpenMappedWebConfiguration(WebConfigurationFileMap, String, String) OpenMappedWebConfiguration(WebConfigurationFileMap, String, String) 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) OpenMappedWebConfiguration(WebConfigurationFileMap, String, String, String) OpenMappedWebConfiguration(WebConfigurationFileMap, String, String, String) 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) OpenWebConfiguration(String) OpenWebConfiguration(String) 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) OpenWebConfiguration(String, String) OpenWebConfiguration(String, String) 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) OpenWebConfiguration(String, String, String) OpenWebConfiguration(String, String, String) 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) OpenWebConfiguration(String, String, String, String) OpenWebConfiguration(String, String, String, String) 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) OpenWebConfiguration(String, String, String, String, IntPtr) OpenWebConfiguration(String, String, String, String, IntPtr) 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) OpenWebConfiguration(String, String, String, String, String, String) OpenWebConfiguration(String, String, String, String, String, String) 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.

Si applica a

Vedi anche