ClickOnce y configuración de la aplicación

La configuración de la Windows Forms facilita la creación, el almacenamiento y el mantenimiento de las preferencias personalizadas de la aplicación y del usuario en el cliente. En el siguiente documento se describe cómo funcionan los archivos de configuración de la aplicación en una aplicación ClickOnce y cómo ClickOnce la configuración cuando el usuario se actualiza a la versión siguiente.

La información siguiente solo se aplica al proveedor de configuración de la aplicación predeterminado, la LocalFileSettingsProvider clase . Si proporciona un proveedor personalizado, ese proveedor determinará cómo almacena sus datos y cómo actualiza su configuración entre versiones. Para obtener más información sobre los proveedores de configuración de aplicaciones, vea Arquitectura de configuración de la aplicación.

Archivos de configuración de la aplicación

La configuración de la aplicación consume dos archivos: <app>.exe.config y user.config, donde app es el nombre de la aplicación Windows Forms. user.config se crea en el cliente la primera vez que la aplicación almacena la configuración de ámbito de usuario. <app>.exe.config, por el contrario, existirá antes de la implementación si define valores predeterminados para la configuración. Visual Studio este archivo se incluirá automáticamente cuando use su comando Publicar. Si crea la aplicación ClickOnce mediante Mage.exe o MageUI.exe, debe asegurarse de que este archivo se incluye con los otros archivos de la aplicación al rellenar el manifiesto de aplicación.

En una aplicación de Windows Forms no implementada mediante ClickOnce, el archivo <app>.exe.config de una aplicación se almacena en el directorio de la aplicación, mientras que el archivo user.config se almacena en la carpeta Documentos y Configuración del usuario. En una aplicación ClickOnce, <app>.exe.config reside en el directorio de la aplicación dentro de la caché de aplicaciones de ClickOnce yuser.configreside en el directorio de datos ClickOnce para esa aplicación.

Independientemente de cómo implemente la aplicación, la configuración de la aplicación garantiza el acceso de lectura seguro <app> a.exe.configy el acceso seguro de lectura y escritura auser.config.

En una ClickOnce, el tamaño de los archivos de configuración utilizados por la configuración de la aplicación está restringido por el tamaño de la caché ClickOnce aplicación. Para obtener más información, vea información general ClickOnce caché de almacenamiento en caché.

Actualizaciones de versiones

Al igual que cada versión de una aplicación ClickOnce está aislada de todas las demás versiones, la configuración de la aplicación para una aplicación de ClickOnce también está aislada de la configuración de otras versiones. Cuando el usuario se actualiza a una versión posterior de la aplicación, la configuración de la aplicación compara la configuración de la versión más reciente (con el número más alto) con la configuración proporcionada con la versión actualizada y combina la configuración en un nuevo conjunto de archivos de configuración.

En la tabla siguiente se describe cómo la configuración de la aplicación decide qué configuración copiar.

Tipo de cambio Acción de actualización
Configuración agregada a <app>.exe.config La nueva configuración se combina con la configuración de la versión <app>.exe.config
Configuración quitada de <app>.exe.config La configuración anterior se quita de la configuración de la versión <app>.exe.config
Se ha cambiado el valor predeterminado de la configuración; configuración local todavía establecida en el valor predeterminado original enuser.config La configuración se combina con la configuración de la versiónuser.config con el nuevo valor predeterminado como valor
Se ha cambiado el valor predeterminado de la configuración; valor establecido en no predeterminado en user.config La configuración se combina en la configuración de la versiónuser.config con el valor no predeterminado retenido

Si ha creado su propia clase contenedora de configuración de la aplicación y desea personalizar la lógica de actualización, puede invalidar el Upgrade método .

ClickOnce configuración de itinerancia

ClickOnce no funciona con la configuración de itinerancia, lo que permite que el archivo de configuración le siga a través de las máquinas de una red. Si necesita una configuración móvil, deberá implementar un proveedor de configuración de la aplicación que almacene la configuración a través de la red o desarrollar sus propias clases de configuración personalizadas para almacenar la configuración en un equipo remoto. Para obtener más información sobre los proveedores de configuración, vea Arquitectura de configuración de la aplicación.

Vea también