Exportar (0) Imprimir
Expandir todo

Configuración de la aplicación

La configuración de la aplicación le permite almacenar y recuperar dinámicamente la configuración de propiedades y cualquier otra información de la aplicación, así como mantener las preferencias de usuario y de la aplicación personalizadas en el equipo cliente. Con frecuencia son datos necesarios, como una cadena de conexión, para ejecutar la aplicación que no desea incluir directamente en el código. Quizá desee almacenar dos cadenas de conexión a bases de datos diferentes y recuperar una de ellas en función de la ubicación del equipo en tiempo de ejecución. O bien, puede almacenar las preferencias de color de un usuario y, a continuación, recuperarlas la siguiente vez que ejecute la aplicación.

Observe que la configuración de la aplicación es una función de Microsoft Visual Studio 2005 que reemplaza la función de propiedades dinámicas de la versión anterior (para obtener más información sobre propiedades dinámicas, vea Configurar aplicaciones mediante propiedades dinámicas).

Cada configuración debe tener un nombre único; el nombre puede ser cualquier combinación de letras, números o un carácter de subrayado que no empiece por un número y sin espacios. Se puede cambiar el nombre mediante la propiedad Name.

La configuración de la aplicación se puede almacenar como cualquier tipo de datos que sea XML serializable o que tenga un TypeConverter que implemente ToString/FromString. Los tipos más comunes son String, Integer y Boolean, pero también puede almacenar valores como Color, Object, o bien como una cadena de conexión.

La configuración de la aplicación también contiene un valor. El valor se establece mediante la propiedad Value y debe coincidir con el tipo de datos de la configuración.

Además, la configuración de la aplicación se puede enlazar directamente a una propiedad de un formulario o de un control en tiempo de diseño. Para obtener más información, vea Cómo: Agregar o quitar valores de configuración de la aplicación.

Hay dos tipos de configuración de la aplicación, en función del ámbito:

  • La configuración de ámbito de aplicación se puede utilizar para obtener información como una dirección URL para un servicio Web o una cadena de conexión a bases de datos. Estos valores se asocian a la aplicación; por tanto, los usuarios no pueden cambiarlos en tiempo de ejecución.

  • La configuración de ámbito de usuario se puede utilizar para obtener información como recordar la última posición de un formulario o una preferencia de fuente. Los usuarios pueden modificar estos valores en tiempo de ejecución.

Puede cambiar el tipo de una configuración con la propiedad Scope.

El sistema del proyecto almacena la configuración de la aplicación en dos archivos XML: un archivo .app.config, que se crea en tiempo de diseño cuando crea la primera configuración de la aplicación, y un archivo .user.config, que se crea en tiempo de ejecución cuando el usuario que ejecuta la aplicación cambia el valor de parte de la configuración de usuario. Observe que los cambios en la configuración de usuario no se escriben en el disco a menos que la aplicación llame específicamente a un método para que lo haga.

Crear la configuración de la aplicación en tiempo de diseño

En tiempo de diseño, hay dos maneras de crear la configuración de la aplicación: mediante la página Configuración del Diseñador de proyectos o desde la ventana Propiedades de un formulario o un control, lo que le permite enlazar una configuración directamente a una propiedad. Para obtener más información, vea Cómo: Agregar o quitar valores de configuración de la aplicación.

Cuando crea una configuración con ámbito de aplicación (por ejemplo, una cadena de conexión a bases de datos o una referencia a los recursos del servidor), Visual Studio la guarda en un archivo app.config con la etiqueta <applicationSettings> (las cadenas de conexión se guardan en la etiqueta <connectionStrings>).

Cuando crea una configuración con ámbito de usuario (por ejemplo, fuente predeterminada, página principal o tamaño de la ventana), Visual Studio la guarda en un archivo app.config con la etiqueta <userSettings>.

Security noteNota de seguridad

Si almacena cadenas de conexión en .app.config, debe tomar precauciones para evitar revelar información confidencial en la cadena de conexión, como contraseñas o rutas de acceso al servidor.

Si toma la información de la cadena de conexión de un origen externo (un usuario que suministre un id. de usuario y una contraseña, por ejemplo), debe asegurarse de que los valores que utilice para crear la cadena de conexión no contengan parámetros adicionales que modifiquen el comportamiento de la conexión.

Plantéese utilizar la función de configuración protegida para cifrar información confidencial en el archivo de configuración. Para obtener más información, vea Proteger cadenas de conexión.

NoteNota

Dado que no hay ningún modelo del archivo de configuración para las bibliotecas de clases, la configuración de la aplicación no se aplica a los proyectos de la biblioteca de clases. La excepción es un proyecto de archivo DLL de Visual Studio Tools para Office, que puede tener un archivo de configuración.

Usar archivos de configuración personalizados

Puede agregar archivos de configuración personalizados a su proyecto para facilitar la administración de grupos de opciones de configuración. Las opciones de configuración contenidas en el mismo archivo se cargan y guardan como una unidad, lo que permite almacenar los valores de configuración en archivos independientes para los grupos que se usen con frecuencia y aquellos que se usen de forma más infrecuente y, de esta manera, ahorrar tiempo al cargar y guardar la configuración.

Por ejemplo, puede agregar un archivo a su proyecto como SpecialSettings.settings. Aunque su clase SpecialSettings no se exponga en el espacio de nombres My, Ver código puede leer el archivo de configuración personalizado que contiene Partial Class SpecialSettings.

El Diseñador de configuración busca primero el archivo Settings.settings creado por el sistema del proyecto; éste es el archivo que muestra de forma predeterminada el Diseñador de configuración en la ficha Configuración. Settings.settings se encuentra en la carpeta My Project para los proyectos de Visual Basic y en la carpeta Propiedades para los proyectos de Visual C#. A continuación, el Diseñador de proyectos busca otros archivos de configuración en la carpeta raíz del proyecto, por lo que debe colocar allí su archivo de configuración personalizado. Si agrega un archivo .settings en otra parte de su proyecto, el Diseñador de proyectos no podrá encontrarlo.

Obtener acceso o cambiar la configuración de la aplicación en tiempo de ejecución en Visual Basic

En los proyectos de Visual Basic, puede obtener acceso a la configuración de la aplicación en tiempo de ejecución por medio del objeto My.Settings. En la página Configuración, haga clic en el botón Ver código con el fin de ver el archivo Settings.vb. Para obtener más información, vea Cómo: Obtener acceso a los eventos de configuración. Settings.vb define la clase Settings, que le permite controlar estos eventos en la clase de configuración: SettingChanging, PropertyChanged, SettingsLoaded y SettingsSaving. Observe que la clase Settings en Settings.vb es una clase parcial, que muestra sólo el código que tiene el usuario, no toda la clase generada. Para obtener más información sobre cómo tener acceso a la configuración de la aplicación utilizando el objeto My.Settings, vea Acceso a la configuración de la aplicación..

Los valores de configuración de ámbito de usuario que el usuario cambia en tiempo de ejecución (por ejemplo, la posición de un formulario) se almacenan en un archivo user.config. Observe que los valores predeterminados se siguen guardando en app.config.

Si ha cambiado parte de la configuración de ámbito de usuario durante el tiempo de ejecución, por ejemplo, al probar la aplicación, y desea restablecer esta configuración a sus valores predeterminados, haga clic en el botón Sincronizar. Para obtener información sobre este control, vea Página Configuración, Diseñador de proyectos.

Es muy recomendable que use el objeto My.Settings y el archivo .settings predeterminado para obtener acceso a la configuración, ya que puede usar el Diseñador de configuración para asignar propiedades a la configuración, y también, la configuración del usuario se guarda automáticamente antes de cerrar la aplicación. Sin embargo, su aplicación de Visual Basic puede obtener acceso directamente a la configuración. En ese caso, necesita tener acceso a la clase MySettings y utilizar un archivo .settings personalizado en la raíz del proyecto. También debe guardar la configuración del usuario antes de finalizar la aplicación, igual que con una aplicación de C#; esto se describe en la sección siguiente.

Obtener acceso o cambiar la configuración de la aplicación en tiempo de ejecución en Visual C#

En lenguajes distintos de Visual Basic, como Visual C# y Visual J#, debe obtener acceso directamente a la clase Settings.

También debe llamar explícitamente al método Save de esta clase contenedora para conservar la configuración del usuario. Esto normalmente se realiza en el controlador de eventos Closing del formulario principal. Para obtener un ejemplo concreto de cómo crear la nueva configuración de la aplicación y enlazarla a las propiedades en su formulario, vea Cómo: Crear una configuración de aplicación mediante el diseñador. Para obtener información más general acerca de cómo obtener acceso a la configuración de la aplicación a través de la clase Settings, vea Información general sobre la configuración de la aplicación.

Vea también

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft