Introducción a la configuración de la aplicación

  • Artículo

En este artículo se describe cómo crear y almacenar los datos de configuración en nombre de la aplicación y sus usuarios.

La característica Configuración de la aplicación de Windows Forms facilita la creación, el almacenamiento y el mantenimiento de las preferencias personalizadas de usuarios y aplicaciones en el equipo cliente. Con Configuración de la aplicación de Windows Forms, no solo puede almacenar datos de las aplicaciones, como cadenas de conexión a bases de datos, sino también datos específicos de los usuarios, como las preferencias de la aplicación de un usuario. Con Visual Studio o código administrado personalizado, puede crear una nueva configuración, leerla y escribirla en el disco, enlazarla a propiedades de los formularios y validar los datos de configuración antes de cargarlos y guardarlos.

La característica Configuración de la aplicación permite a los desarrolladores guardar el estado en la aplicación con muy poco código personalizado, y sustituye a las propiedades dinámicas de las versiones anteriores de .NET Framework. Configuración de la aplicación ofrece muchas mejoras en comparación con las propiedades dinámicas, que son de solo lectura, se enlazan en tiempo de ejecución y requieren más programación personalizada. Las clases de las propiedades dinámicas se conservan en .NET Framework 2.0, pero son solo clases contenedoras de las clases de Configuración de la aplicación.

¿Qué es Configuración de la aplicación?

Las aplicaciones de Windows Forms, a menudo, requieren datos que son esenciales para ejecutar la aplicación, pero que no quiere incluir directamente en el código de la aplicación. Si la aplicación utiliza un servicio web o un servidor de bases de datos, puede que le convenga almacenar esta información en un archivo independiente, para poder cambiarla en el futuro sin tener que volver a compilarla. De manera similar, puede que las aplicaciones necesiten almacenar datos específicos del usuario actual. La mayoría de las aplicaciones, por ejemplo, tienen preferencias del usuario con las que se personalizan la apariencia y el comportamiento de la aplicación.

La característica Configuración de la aplicación cubre estas dos necesidades proporcionando una manera sencilla de almacenar tanto la configuración del ámbito del usuario como la del ámbito de la aplicación en el equipo cliente. Con Visual Studio o un editor de código, puede definir una configuración para una propiedad determinada especificando su nombre, el tipo de datos y el ámbito (aplicación o usuario). Incluso puede colocar configuraciones relacionadas en grupos con nombres para simplificar su uso y su legibilidad. Una vez definida, esta configuración se conserva y se lee en la memoria automáticamente en tiempo de ejecución. Una arquitectura acoplable permite cambiar el mecanismo de persistencia, pero de forma predeterminada, se utiliza el sistema de archivos local.

Configuración de la aplicación funciona mediante la persistencia de los datos en XML para archivos de configuración (.config) diferentes, según si la configuración es del ámbito de la aplicación o del ámbito del usuario. En la mayoría de los casos, la configuración del ámbito de la aplicación es de solo lectura. Dado que es información del programa, lo normal es que no tenga que sobrescribirla. Por el contrario, la configuración del ámbito del usuario se puede leer y escribir de manera segura en tiempo de ejecución, aunque la aplicación se ejecute con confianza parcial. Para obtener más información acerca de la confianza parcial, consulte Security in Windows Forms Overview.

Las configuraciones se almacenan como fragmentos XML en archivos de configuración. La configuración del ámbito de la aplicación se representa con el elemento <applicationSettings> y, generalmente, se coloca en aplicación.exe.config, donde aplicación es el nombre del archivo ejecutable principal. La configuración con ámbito de usuario se representa mediante el elemento <userSettings> y se coloca en user.config. El archivo app.exe.config se debe implementar con la aplicación. La arquitectura de la configuración creará el archivo user.config según sea necesario la primera vez que la aplicación guarde la configuración de cada usuario. También puede definir un bloque <userSettings> en aplicación.exe.config para proporcionar los valores predeterminados de la configuración del ámbito del usuario.

Los controles personalizados también pueden guardar su propia configuración implementando la interfaz IPersistComponentSettings , que expone el método SaveSettings . El control ToolStrip de Windows Forms implementa esta interfaz para guardar la posición de las barras de herramientas y los elementos de las barras de herramientas entre una sesión de la aplicación y otra. Para obtener más información acerca de los controles personalizados y la configuración de la aplicación, consulte Application Settings for Custom Controls.

Dónde se almacenan las opciones de configuración de ámbito de usuario

El proveedor predeterminado, LocalFileSettingsProvider, almacena la configuración de ámbito de usuario en la carpeta LocalApplicationData. Si esa carpeta no está disponible, en su lugar se usa la carpeta ApplicationData. Se crea una subcarpeta específica de la aplicación para almacenar el archivo de configuración con ámbito de usuario. El nombre de esta carpeta se basa en tres atributos sobre el ensamblado principal de la aplicación:

  • Elemento CompanyName del ensamblado.
  • Valor hash basado en dos fragmentos de información:
    • Elemento FriendlyName del ensamblado. Si FriendlyName no está disponible, se usa ProductName.
    • Elemento StrongName del ensamblado si está disponible; de lo contrario, se usa la ruta de acceso de carpeta absoluta al ensamblado.
  • Cadena AssemblyName.Version.

Si alguno de los detalles del ensamblado anterior cambia, se pierde la configuración de ámbito de usuario anterior porque se genera un nuevo nombre de subcarpeta. Por ejemplo, si se publica una nueva versión de la aplicación y el valor de AssemblyName.Version es diferente de la versión anterior, cambiará el nombre de la subcarpeta que se usa para almacenar la configuración de ámbito de usuario. Si la configuración del usuario debe conservarse entre las versiones de la aplicación, crea un proveedor de configuración personalizado. Para más información, consulta Proveedores de configuración personalizados.

Limitaciones de Configuración de la aplicación

No puede utilizar Configuración de la aplicación en una aplicación no administrada que hospede el .NET Framework. La configuración no funciona en entornos como los complementos de Visual Studio, C++ para Microsoft Office, el hospedaje de controles en Internet Explorer o los complementos y proyectos de Microsoft Outlook.

Actualmente, no es posible enlazar a algunas propiedades en Windows Forms. El ejemplo más notable es la propiedad ClientSize : si se enlaza a esta propiedad, puede producirse un comportamiento impredecible en tiempo de ejecución. Normalmente, puede solucionar estos problemas guardando y cargando estas opciones con programación.

Configuración de la aplicación no tiene ninguna funcionalidad integrada para cifrar la información de forma automática. Nunca debe almacenar información relacionada con la seguridad, como contraseñas de bases de datos, en texto no cifrado. Si quiere almacenar ese tipo de información confidencial, como desarrollador de la aplicación, es usted el responsable de asegurarse de que esté protegida. Si quiere almacenar cadenas de conexión, le recomendamos que utilice la seguridad integrada de Windows y que no recurra a especificar las contraseñas de forma rígida en la dirección URL. Para obtener más información, consulta Code Access Security and ADO.NET.

Introducción a Configuración de la aplicación

Si utiliza Visual Studio, puede definir la configuración en el Diseñador de Windows Forms con la propiedad (ApplicationSettings) en la ventana Propiedades . Al definir la configuración de esta forma, Visual Studio crea automáticamente una clase contenedora administrada personalizada que asocia cada ajuste a una propiedad de clase. Visual Studio también se ocupa de enlazar el ajuste a una propiedad de un formulario o control para que la configuración del control se restaure automáticamente cuando se muestre su formulario y se guarde automáticamente al cerrar el formulario.

Si quiere controlar la configuración con más precisión, puede definir su propia clase contenedora de configuración de la aplicación personalizada. Para hacerlo, derive una clase de ApplicationSettingsBase, agregue una propiedad que corresponda a cada ajuste y aplique atributos especiales a estas propiedades. Para obtener más información acerca de cómo crear clases contenedoras, consulte Application Settings Architecture.

También puede utilizar la clase Binding para enlazar la configuración con programación a las propiedades de formularios y controles.

Consulte también