Página Configuración, Diseñador de proyectos

Use la página Configuración del Diseñador de proyectos para especificar la configuración de la aplicación de un proyecto. La configuración de la aplicación permite almacenar y recuperar valores de propiedad y otros datos para la aplicación de forma dinámica. También permite mantener la aplicación y las preferencias del usuario personalizadas en un equipo cliente. Para más información, consulte Administración de la configuración de las aplicaciones.

Para acceder a la página Configuración, seleccione un nodo de proyecto en el Explorador de soluciones, haga clic con el botón derecho y, en el menú contextual, seleccione Propiedades. Cuando aparezca el Diseñador de proyectos, seleccione la pestaña Configuración.

En la pestaña Configuración, verá el vínculo Crear o abrir la configuración de la aplicación.

Screenshot of the Settings tab in the Project Designer for a WPF project in Visual Studio 2022, where you click a link to dynamically generate the Settings dialog.

Seleccione el vínculo Crear o abrir la configuración de la aplicación para abrir la página Configuración en el Diseñador de proyectos.

Screenshot of the Settings tab in the Project Designer for a WPF project in Visual Studio 2022.

Screenshot of the Settings tab in the Project Designer for a WPF project in Visual Studio 2019.

Barra de encabezado

La barra de encabezado de la parte superior de la página Configuración contiene varios controles:

Sincronizar

Sincronizar restaura la configuración con ámbito de usuario que usa la aplicación en tiempo de ejecución o durante la depuración a sus valores predeterminados, tal como se define en tiempo de diseño. Para restaurar los datos, quite los archivos específicos de la aplicación generados en tiempo de ejecución del disco, pero no de los datos del proyecto.

Cargar configuración web

Cargar configuración web muestra un cuadro de diálogo Iniciar sesión que permite cargar la configuración para un usuario autenticado o para usuarios anónimos. Este botón se habilita solo cuando se han habilitado los servicios de aplicación cliente en la página Servicios y se ha especificado una Ubicación del servicio de configuración web.

Vista Código

Para proyectos de C#, el botón Vista Código permite ver el código en el archivo Settings.cs. Este archivo define la clase Settings, lo que permite controlar eventos específicos en el objeto Settings. En los lenguajes que no sean Visual Basic, 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 Cerrando del formulario principal. Lo siguiente es un ejemplo de una llamada al método Save:

Properties.Settings.Default.Save();

Para proyectos de Visual Basic, el botón Vista Código permite ver el código en el archivo Settings.vb. Este archivo define la clase MySettings, lo que permite controlar eventos específicos en el objeto My.Settings. Para obtener más información sobre cómo tener acceso a la configuración de la aplicación mediante el objeto My.Settings, vea Acceso a la configuración de la aplicación.

Para obtener más información sobre el acceso a la configuración de la aplicación, vea Configuración de la aplicación en formularios Windows Forms.

Modificador de acceso

El botón Modificador de acceso especifica el nivel de acceso de las clases del asistente Properties.Settings (en C#) o My.Settings (en Visual Basic) que Visual Studio genera en Settings.Designer.cs o Settings.Designer.vb.

Para proyectos de Visual C#, el modificador de acceso puede ser Interno o Público.

Para proyectos de Visual Basic, el modificador de acceso puede ser Amigo o Público.

De forma predeterminada, el valor es Interno en C# y Amigo en Visual Basic. Cuando Visual Studio genera clases del asistente como Interno o Amigo, las aplicaciones ejecutables (.exe) no pueden acceder a los recursos y la configuración que ha agregado a las bibliotecas de clases (archivos .dll). Si tiene que compartir recursos y la configuración de una biblioteca de clases, establezca el modificador de acceso en Público.

Para obtener más información sobre las clases del asistente de configuración, vea Administración de la configuración de la aplicación.

Cuadrícula Configuración

La cuadrícula Configuración se usa para configurar la configuración de la aplicación. Esta cuadrícula incluye las siguientes columnas:

Nombre

Escriba el nombre de la configuración de la aplicación en este campo.

Tipo

Use la lista desplegable para seleccionar un tipo de configuración. Los tipos utilizados con mayor frecuencia aparecen en la lista desplegable, por ejemplo, Cadena, (Cadena de conexión) y System.Drawing.Font. Puede elegir otro tipo si hace clic en Examinar al final de la lista y elige un tipo en el cuadro de diálogo Select a Type (Seleccionar un tipo). Después de elegir un tipo, este se agrega a los tipos comunes en la lista desplegable (solo para la solución actual).

Importante

Examinar solo está disponible para los proyectos de .NET Framework. Examinar no está disponible para los proyectos de .NET o .NET Core.

Ámbito

Seleccione Aplicación o Usuario.

La configuración de ámbito de la aplicación, como las cadenas de conexión, está asociada con la aplicación. Los usuarios no pueden cambiar la configuración de ámbito de la aplicación en tiempo de ejecución.

La configuración de ámbito de usuario, como las fuentes del sistema, está diseñada para usarse en las preferencias del usuario. Los usuarios pueden cambiarla en tiempo de ejecución.

Valor

Los datos o el valor asociado con la configuración de la aplicación. Por ejemplo, si el valor es una fuente, su valor podría ser Verdana, 9.75pt, style=Bold.

Consulte también