WebConfigurationManager Clase

Definición

public ref class WebConfigurationManager abstract sealed

public static class WebConfigurationManager

type WebConfigurationManager = class

Public Class WebConfigurationManager

Herencia

Object

WebConfigurationManager

Ejemplos

En el ejemplo siguiente se muestra cómo acceder a la información de configuración con .

Método GetSection.

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

Comentarios

La WebConfigurationManager clase permite acceder a la información del equipo y de la aplicación.

El uso WebConfigurationManager de es la manera preferida de trabajar con archivos de configuración relacionados con las aplicaciones web. Para las aplicaciones cliente, use la ConfigurationManager clase .

La aplicación puede ampliar los System.Configuration tipos o usarlos directamente para controlar la información de configuración, como se explica en la lista siguiente:

• Handling configuration. Para controlar la información de configuración mediante los tipos estándar, use uno de los métodos siguientes:

  • Accessing a section. Para acceder a la información de configuración de la aplicación, debe usar uno de los GetSection métodos proporcionados por WebConfigurationManager. Para <appSettings> y <connectionStrings>, se usan las AppSettings propiedades y ConnectionStrings . Estos métodos realizan operaciones de solo lectura, usan una única instancia almacenada en caché de la configuración y son compatibles con varios subprocesos.

  • Accessing configuration files. La aplicación puede leer y escribir opciones de configuración en cualquier nivel, para sí mismo o para otras aplicaciones o equipos, de forma local o remota. Use uno de los open métodos proporcionados por WebConfigurationManager. Estos métodos devolverán un Configuration objeto , que a su vez proporciona los métodos y propiedades necesarios para controlar los archivos de configuración subyacentes. Estos métodos realizan operaciones de lectura o escritura y vuelven a crear los datos de configuración cada vez que se abre un archivo.

  • Advanced configuration. El control de configuración más avanzado lo proporcionan los tipos SectionInformation, , ElementInformationPropertyInformationPropertyInformationCollection, ContextInformation, , ConfigurationSectionGroupy ConfigurationSectionGroupCollection.

• Extending configuration standard types. También puede proporcionar los elementos de configuración personalizados mediante la extensión de los tipos de configuración estándar, como ConfigurationElement, ConfigurationElementCollectionConfigurationProperty, y ConfigurationSection mediante un modelo con atributos o mediante programación. Consulte la ConfigurationSection clase para obtener un ejemplo de cómo extender un tipo de configuración estándar mediante programación. Consulte la ConfigurationElement clase para obtener un ejemplo de cómo ampliar un tipo de configuración estándar mediante el modelo con atributos.

Notas a los desarrolladores de herederos

La Configuration clase permite el acceso mediante programación para editar archivos de configuración. Use uno de los métodos abiertos proporcionados por WebConfigurationManager. Estos métodos devolverán un Configuration objeto , que a su vez proporciona los métodos y propiedades necesarios para controlar los archivos de configuración subyacentes. Puede acceder a estos archivos para leer o escribir de la siguiente manera:

GetSection(String) Use o GetSectionGroup(String) para leer la información de configuración. Tenga en cuenta que el usuario o proceso que lee debe tener los permisos siguientes:

• Permiso de lectura en el archivo de configuración en el nivel de jerarquía de configuración actual.

• Permisos de lectura en todos los archivos de configuración primarios.

Si la aplicación necesita acceso de solo lectura a su propia configuración, se recomienda usar los GetSection métodos . Estos métodos proporcionan acceso a los valores de configuración almacenados en caché para la aplicación actual, que tiene un mejor rendimiento que la Configuration clase .

Nota: Si usa un método estático GetSection que toma un path parámetro, el parámetro path debe hacer referencia a la aplicación en la que se ejecuta el código; de lo contrario, se omite el parámetro y se devuelve la información de configuración de la aplicación que se está ejecutando actualmente.

Use uno de los Save métodos para escribir información de configuración. Tenga en cuenta que el usuario o proceso que escribe debe tener los permisos siguientes:

• Permiso de escritura en el archivo de configuración y el directorio en el nivel de jerarquía de configuración actual.

• Permisos de lectura en todos los archivos de configuración.

Propiedades

Métodos

Se aplica a

Consulte también

• Configuration
• ConfigurationManager
• Información general sobre la configuración de ASP.NET