Una instancia de la clase Configuration representa la vista combinada de los valores de configuración que se aplican a una entidad física concreta, como un equipo, o a una entidad lógica, como una aplicación o sitio Web. La entidad lógica especificada puede existir en el equipo local o en un servidor remoto.
Cuando no existe ningún archivo de configuración para una entidad especificada, el objeto Configuration representa los valores de configuración predeterminados, tal como los define el archivo Machine.config.
Se puede obtener acceso a un objeto Configuration utilizando uno de los métodos de configuración abierta que definen las clases siguientes:
Para generar un archivo de configuración que represente los valores de configuración heredados para una entidad especificada, utilice uno de los métodos para guardar la configuración:
Nota |
|---|
| Para permitir el acceso a los valores de configuración en un equipo remoto, utilice la herramienta de línea de comandos Aspnet_regiis. Para obtener más información sobre esta herramienta, vea Herramienta Registro de IIS en ASP.NET (Aspnet_regiis.exe). Para obtener información sobre la forma de crear y obtener acceso a los valores de configuración personalizados distintos de las secciones intrínsecas incluidas en .NET Framework, vea ConfigurationSection. |
Notas para los implementadores Configuration es la clase que permite el acceso mediante programación para editar archivos de configuración. Se puede utilizar uno de los métodos abiertos proporcionados por
WebConfigurationManager para las aplicaciones Web o por
ConfigurationManager para las aplicaciones cliente. Estos métodos devuelven un objeto
Configuration que, a su vez, proporciona los métodos y propiedades necesarios para controlar los archivos de configuración subyacentes. Puede obtener acceso de lectura o escritura a estos archivos, tal como se explica a continuación.
Si la aplicación necesita acceso de sólo lectura a su propia configuración, para las aplicaciones Web se recomienda utilizar las sobrecargas del método
GetSection. Para el caso de las aplicaciones cliente, se recomienda el método
GetSection.
Estos métodos proporcionan acceso a los valores de configuración almacenados en memoria caché para la aplicación actual, cuyo rendimiento es mejor que el de la clase
Configuration.
Nota |
|---|
| Si utiliza un método estático GetSection que tome un parámetro de ruta, dicho parámetro de ruta debe hacer referencia a la aplicación en la que se está ejecutando el código; de lo contrario, se omitirá el parámetro y se devolverá la información de configuración de la aplicación que se esté ejecutando en ese momento. |