Cómo: Crear cuadrículas de propiedades para la configuración del usuario en Visual Basic

  • Artículo

Una cuadrícula de propiedades para la configuración del usuario se crea rellenando un control PropertyGrid con las propiedades de configuración de usuario del objeto My.Settings.

Nota

Para que funcione este ejemplo, la aplicación debe tener configurados los ajustes del usuario. Para obtener más información, vea Administrar la configuración de la aplicación (.NET).

El objeto My.Settings expone cada configuración como una propiedad. El nombre de propiedad es el mismo que el nombre de la configuración y el tipo de propiedad es el mismo que el tipo de configuración. El Ámbito de la configuración determina si la propiedad es de solo lectura. La propiedad de una configuración con ámbito Aplicación es de solo lectura, mientras que la propiedad de una configuración con ámbito Usuario es de lectura y escritura. Para obtener más información, vea My.Settings (Objeto).

Nota

No se pueden cambiar ni guardar los valores de configuración de ámbito de aplicación en tiempo de ejecución. Las configuraciones con ámbito de aplicación únicamente se pueden cambiar al crear la aplicación (mediante el Diseñador de proyectos) o editando el archivo de configuración de la aplicación. Para obtener más información, vea Administrar la configuración de la aplicación (.NET).

Este ejemplo usa un control PropertyGrid para acceder a las propiedades de configuración de usuario del objeto My.Settings. De forma predeterminada, PropertyGrid muestra todas las propiedades del objeto My.Settings. Sin embargo, las propiedades de configuración de usuario tienen el atributo UserScopedSettingAttribute. Este ejemplo establece la propiedad BrowsableAttributes de PropertyGrid en UserScopedSettingAttribute para mostrar solo las propiedades de configuración de usuario.

Para agregar una cuadrícula de propiedades de configuración de usuario

  1. Agregue el control PropertyGrid desde el Cuadro de herramientas a la superficie de diseño de la aplicación, que aquí se da por supuesto que es Form1.

    El nombre predeterminado del control de cuadrícula de propiedades es PropertyGrid1.

  2. Haga doble clic en la superficie de diseño de Form1 para abrir el código del controlador de eventos de carga del formulario.

  3. Establezca el objeto My.Settings como el objeto seleccionado para la cuadrícula de propiedades.

    PropertyGrid1.SelectedObject = My.Settings

  4. Configure la cuadrícula de propiedades para que solo muestre la configuración de usuario.

    ' Attribute for the user-scope settings.
Dim userAttr As New System.Configuration.UserScopedSettingAttribute
Dim attrs As New System.ComponentModel.AttributeCollection(userAttr)
PropertyGrid1.BrowsableAttributes = attrs

    Nota

    Para mostrar solo la configuración del ámbito de aplicación, utilice el atributo ApplicationScopedSettingAttribute en lugar de UserScopedSettingAttribute.

Programación sólida

La aplicación guarda la configuración del usuario cuando se cierra. Para guardar la configuración inmediatamente, llame al método My.Settings.Save. Para obtener más información, vea Cómo: Conservar la configuración del usuario en Visual Basic.

Vea también